Skip to content

Issue 666: Add UcoType and Technique#676

Open
ajnelson-nist wants to merge 15 commits into
developfrom
Feature-Issue-666
Open

Issue 666: Add UcoType and Technique#676
ajnelson-nist wants to merge 15 commits into
developfrom
Feature-Issue-666

Conversation

@ajnelson-nist

@ajnelson-nist ajnelson-nist commented Apr 10, 2026

Copy link
Copy Markdown
Contributor

This Pull Request resolves all backwards-compatible requirements of Issue #666 .

Coordination

  • Pull Request is against correct branch
  • Pull Request is in, or reverted to, Draft status before Solutions Approval vote has passed
  • Documentation confirmed to render metaclass
  • CI passes in UCO feature branch against develop
  • CI passes in UCO current unstable branch (fdc106b)
  • CI passes in CASE current unstable branch tracking UCO's unstable as submodule (36886a9)
  • Impact on SHACL validation reviewed for CASE-Corpora
  • Impact on SHACL validation remediated for CASE-Corpora (N/A)
  • Impact on SHACL validation reviewed for CASE-Examples
  • Impact on SHACL validation remediated for CASE-Examples (N/A)
  • Impact on SHACL validation reviewed for casework.github.io
  • Impact on SHACL validation remediated for casework.github.io (N/A)
  • Milestone linked
  • Solutions Approval vote logged on corresponding Issue (once logged, can be taken out of Draft PR status)

…rarchy

A follow-on patch will regenerate Make-managed files.

References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
A follow-on patch will regenerate Make-managed files.

References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
A follow-on patch will regenerate Make-managed files.

References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
A follow-on patch will regenerate Make-managed files.

References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
No effects were observed on prior Make-managed files.

References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
A follow-on patch will regenerate Make-managed files.

References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
A follow-on patch will regenerate Make-managed files.

References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
No effects were observed on Make-managed files.

References:
* #666 (comment)

Requested-by: Cory Hall <corylloydhall@gmail.com>
Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
@ajnelson-nist

Copy link
Copy Markdown
Contributor Author

In the last call, we'd left a note-to-selves to confirm the documentation would render this implementation.

I can confirm the documentation renders as at least I expected. Unfortunately, I can't think of a clean way to "Preview" the documentation aside from suggesting any interested reviewers pull down local HTML pages themselves. The generated documentation, with static HTML, is in this branch, and pages can be opened from local disk without executing anything. E.g.:

  • documentation/class-ex1technique.html - see the metaclass ex1:Technique, which specializes uco-action:Technique.
  • documentation/class-ex1technique-t0001.html - see an instance of Technique.

This engine does not appear to support any particular emphasis that the class "T0001" is an instance of a different class hierarchy. The Turtle snippets excerpted from the ontology at the bottom of class pages do include the instance-of-something-custom designation (ex1:Technique-T0001 a ex1:Technique, owl:Class ; ...), but nothing else really visualizes a bridge from class to metaclass. This is not intended as a criticism - it just doesn't seem to have been a feature on the engine's radar.

"SOP" was acknowledged to be a term of a sufficiently different scoping.

Turtle files were intentionally not normalized in this patch, to avoid
confusion from string-replacements.  Normalizing later is acceptable.

A follow-on patch will regenerate Make-managed files.

References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
References:
* #666

Signed-off-by: Alex Nelson <alexander.nelson@nist.gov>
@ajnelson-nist

Copy link
Copy Markdown
Contributor Author

This PR is ready for review and merge. Please, to the requested reviewers:

  • Please do not merge before CI passes on commit 871bb29.
  • As requested, "SOP" and "procedure" have been removed from the new tests, but to avoid confusion I just put "Technique" back in under the second example-organization's namespace, avoiding synonyms. If it's too confusing because of term overuse, please do suggest another synonym.
  • If CI has passed and the other review has Approved, the second reviewer should feel free to merge when they approve.

@ajnelson-nist ajnelson-nist marked this pull request as ready for review June 30, 2026 15:48
@ajnelson-nist ajnelson-nist requested review from a team and eoghanscasey June 30, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add uco-action:Technique class and associated properties to enhance UCO's ability to better represent technique-oriented community efforts

1 participant