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

Remove with-parent-controls developmental feature #1819

Conversation

david-waltermire
Copy link
Contributor

@david-waltermire david-waltermire commented Jun 26, 2023

Committer Notes

This PR revert changes from #1717 that address a documented feature in the profile resolution spec that didn't exist in the OSCAL profile model. Instead of updating the model, this PR removes the "with-parent-controls" feature from the profile resolution spec.

This developmental feature should be removed for the following reasons.

  • This feature is not implemented in any of the current XSLT or Java implementations.
  • This feature is not being requested from a significant segment of the user community. The related issue oscal_complete_schema.xsd (v1.0.4) lacks with-parent-controls attribute of include-controls element #1662 has support from 1 community member outside the NIST team.
  • This feature is extremely difficult to implement along with with-child-controls, which works on the opposite axis.
  • IMHO, profile resolution doesn't need to be made more complicated than it already is.

All Submissions:

By submitting a pull request, you are agreeing to provide this contribution under the CC0 1.0 Universal public domain dedication.

(For reviewers: The wiki has guidance on code review and overall issue review for completeness.)

Changes to Core Features:

  • Have you added an explanation of what your changes do and why you'd like us to include them?
  • Have you written new tests for your core changes, as applicable?
  • Have you included examples of how to use your new feature(s)?
  • Have you updated all OSCAL website and readme documentation affected by the changes you made? Changes to the OSCAL website can be made in the docs/content directory of your branch.

…in the profile resolution spec that didn't exist in the model. Instead of updating the model, this PR removes the "with-parent-controls" feature from the profile resolution spec.

This developmental feature should be removed for the following reasons.
- This feature is not implemented in any of the current XSLT or Java implementations.
- This feature is not being requested from a significant segment of the user community. The related issue usnistgov#1662 has support from 1 community member outside the NIST team.
- This feature is extremely difficult to implement along with with-child-controls, which works on the opposite axis.
- IMHO, profile resolution doesn't need to be made more complicated than it already is.
wendellpiez
wendellpiez previously approved these changes Jun 27, 2023
Copy link
Contributor

@wendellpiez wendellpiez left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need a followup issue to modify the Profile Resolution Specification?

LGTM in any case.

@aj-stein-nist
Copy link
Contributor

Do we need a followup issue to modify the Profile Resolution Specification?

Specification has been updated in the PR before review, so looks to go to review, I am doing so now.

Copy link
Contributor

@aj-stein-nist aj-stein-nist left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The with-parent-controls flag is still included in dangling code even if removed by select-control-by-id, we need to remove that first.

NOTE to NIST Team: let's make sure we use the reviewer guidance re the checklist and checking for dead code during review.

@aj-stein-nist
Copy link
Contributor

I am going to rebase with the Markdown fix soon enough, so I will merge this first.

@aj-stein-nist aj-stein-nist merged commit bb4a4c4 into usnistgov:develop Jun 29, 2023
aj-stein-nist added a commit to aj-stein-nist/OSCAL-forked that referenced this pull request Jun 29, 2023
* Revert changes from usnistgov#1717 that address a documented feature in the profile resolution spec that didn't exist in the model. Instead of updating the model, this PR removes the "with-parent-controls" feature from the profile resolution spec.

This developmental feature should be removed for the following reasons.
- This feature is not implemented in any of the current XSLT or Java implementations.
- This feature is not being requested from a significant segment of the user community. The related issue usnistgov#1662 has support from 1 community member outside the NIST team.
- This feature is extremely difficult to implement along with with-child-controls, which works on the opposite axis.
- IMHO, profile resolution doesn't need to be made more complicated than it already is.

* PR review, delete dangling with-parent-controls flag.

---------

Co-authored-by: A.J. Stein <[email protected]>
@aj-stein-nist aj-stein-nist linked an issue Jul 7, 2023 that may be closed by this pull request
8 tasks
aj-stein-nist added a commit to aj-stein-nist/OSCAL-forked that referenced this pull request Jul 10, 2023
* Revert changes from usnistgov#1717 that address a documented feature in the profile resolution spec that didn't exist in the model. Instead of updating the model, this PR removes the "with-parent-controls" feature from the profile resolution spec.

This developmental feature should be removed for the following reasons.
- This feature is not implemented in any of the current XSLT or Java implementations.
- This feature is not being requested from a significant segment of the user community. The related issue usnistgov#1662 has support from 1 community member outside the NIST team.
- This feature is extremely difficult to implement along with with-child-controls, which works on the opposite axis.
- IMHO, profile resolution doesn't need to be made more complicated than it already is.

* PR review, delete dangling with-parent-controls flag.

---------

Co-authored-by: A.J. Stein <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Revert with-parent-controls from profile schemas and update specification
3 participants