Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Misleading XML Schema documentation for control-implementation implemented-requirement #1194

Closed
GaryGapinski opened this issue Apr 1, 2022 · 1 comment · Fixed by #1232
Closed
Assignees
Labels
Milestone

Comments

@GaryGapinski
Copy link

Describe the bug

This was recently discussed and an issue was requested.

See the 1.0.2 complete XML schema line 2672.

The prose statement implies semantic equivalency of <implemented-requirement> in both <system-security-plan> and <component-definition>. The element name assists with such an interpretation.

Who is the bug affecting?

Developers who rely on XML Schema documentation.

What is affected by this bug?

Despite the element name equality, the semantic import is supposedly different.

When does this occur?

Durably (unless the documentation were to be changed).

Expected behavior (i.e. solution)

Identically named elements in different OSCAL documents have identical semantic import.

@david-waltermire david-waltermire self-assigned this Apr 5, 2022
@david-waltermire david-waltermire added this to the OSCAL 1.0.3 milestone Apr 5, 2022
@david-waltermire
Copy link
Contributor

The relevant objects in the component definition need to be clarified that the control details are suggestions for possible implementations in the component definition. In the SSP, the relevant objects document what was actually implemented.

This needs to be clarified in the relevant metaschemas.

david-waltermire added a commit to david-waltermire/OSCAL that referenced this issue May 4, 2022
…inition as only a suggestion of how to implement. Resolves usnistgov#1194.
david-waltermire added a commit that referenced this issue May 5, 2022
…inition as only a suggestion of how to implement. Resolves #1194. (#1232)
david-waltermire added a commit that referenced this issue May 5, 2022
…inition as only a suggestion of how to implement. Resolves #1194. (#1232)
Rene2mt pushed a commit to Rene2mt/OSCAL that referenced this issue May 17, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants