Aliases to old control layer catalog layer subdirectory examples missing

[aj-stein-nist]

Per an earlier report from community members via @iMichaela, some other aliaseses were not added by me in #38 for #24. The following are SP 800-53 example page of missing control layer link issues that must have aliases added.

• Add alias /resources/concepts/layer/control/catalog/sp800-53rev5-example/ -> /concepts/layer/control/catalog/sp800-53rev5-example/
• Review all /resources subdirectory pages and ensure all aliases are updated
• Review with tech lead and team to determine best course of action for link checking external to the site and consider checking historic links pre-alias for better testing, if feasible

[aj-stein-nist]

Given the approval and changes in usnistgov/OSCAL-Reference#22, it seems we should triage this as some links are still missing.

/cc @Arminta-Jenkins-NIST

[Arminta-Jenkins-NIST]

At 9/28 Triage Meeting: @nikitawootten-nist - Hugo generated site map file can help find these issues.

[iMichaela]

Pages with invalid links are listed below, and the broken links are included. Finding the best way of programmatically addressing them to point to the latest OSCAL release and not hardcoded to v1.1.1 would be important.

• https://pages.nist.gov/OSCAL/resources/concepts/layer/control/catalog/ (see the table with links)

  • JSON Schema: https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_catalog_schema.json needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_catalog_schema.json
  • XML Schema: https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_catalog_schema.xsd needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_catalog_schema.xsd
  • XML to JSON Converter: https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_catalog_xml-to-json-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_catalog_xml-to-json-converter.xsl
  • https://github.com/usnistgov/OSCAL/tree/main/json#converting-oscal-xml-content-to-json should probably be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters
  • JSON to XML Converter: https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_catalog_json-to-xml-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_catalog_json-to-xml-converter.xsl
  • https://github.com/usnistgov/OSCAL/tree/main/xml#converting-oscal-json-content-to-xml could probably be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters

• https://pages.nist.gov/OSCAL/resources/concepts/layer/control/profile/ (see the table with links)

  • JSON Schema: https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_profile_schema.json needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_profile_schema.xsd
  • XML to JSON Converter: https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_profile_xml-to-json-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_profile_xml-to-json-converter.xsl
  • https://github.com/usnistgov/OSCAL/tree/main/json#converting-oscal-xml-content-to-json could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters
  • XML Schema: https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_profile_schema.xsd needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_profile_schema.xsd
  • JSON to XML Converter: https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_profile_json-to-xml-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_catalog_json-to-xml-converter.xsl
  • Content Examples FedRAMP Baselines | [XML] [JSON] [YAML] <-- need to be replaced with fedramp-automation URLs

• https://pages.nist.gov/OSCAL/resources/concepts/layer/implementation/component-definition/

  • JSON Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_component_schema.json needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_component_schema.json
  • XML to JSON Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_component_xml-to-json-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_component_xml-to-json-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/json#converting-oscal-xml-content-to-json could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters
  • XML Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_component_schema.xsd needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_component_schema.xsd
  • JSON to XML Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_component_json-to-xml-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_component_json-to-xml-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/xml#converting-oscal-json-content-to-xml could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters

• https://pages.nist.gov/OSCAL/resources/concepts/layer/implementation/ssp/

  • JSON Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_ssp_schema.json needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_ssp_schema.json
  • XML to JSON Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_ssp_xml-to-json-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_ssp_xml-to-json-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/json#converting-oscal-xml-content-to-json could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters
  • XML Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_ssp_schema.xsd needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_ssp_schema.xsd
  • JSON to XML Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_ssp_json-to-xml-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_ssp_json-to-xml-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/xml#converting-oscal-json-content-to-xml could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters

• https://pages.nist.gov/OSCAL/learn/tutorials/:

  • Testing new releases: https://pages.nist.gov/OSCAL/learn/tutorials/releases/ needs to be replaced with: https://pages.nist.gov/OSCAL/learn/tutorials/general/releases/

• https://pages.nist.gov/OSCAL/resources/concepts/layer/assessment/assessment-plan/

  • JSON Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_assessment-plan_schema.json needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_assessment-plan_schema.json
  • XML to JSON Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_assessment-plan_xml-to-json-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_assessment-plan_xml-to-json-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/json#converting-oscal-xml-content-to-json could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters
  • XML Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_assessment-plan_schema.xsd needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_assessment-plan_schema.xsd
  • JSON to XML Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_assessment-plan_json-to-xml-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_assessment-plan_json-to-xml-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/xml#converting-oscal-json-content-to-xml could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters

• https://pages.nist.gov/OSCAL/resources/concepts/layer/assessment/assessment-results/

  • JSON Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_assessment-results_schema.json needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_assessment-results_schema.json
  • XML to JSON Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_assessment-results_xml-to-json-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_assessment-results_xml-to-json-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/json#converting-oscal-xml-content-to-json could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters
  • XML Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_assessment-results_schema.xsd needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_assessment-results_schema.xsd
  • JSON to XML Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_assessment-results_json-to-xml-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_assessment-results_json-to-xml-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/xml#converting-oscal-json-content-to-xml could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters

• https://pages.nist.gov/OSCAL/resources/concepts/layer/assessment/poam/

  • JSON Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_poam_schema.json needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_poam_schema.json
  • XML to JSON Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_poam_xml-to-json-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_poam_xml-to-json-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/json#converting-oscal-xml-content-to-json could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters
  • XML Schema : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_poam_schema.xsd needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_poam_schema.xsd
  • JSON to XML Converter : https://pages.nist.gov/OSCAL-Reference/release-assets/latest/oscal_poam_json-to-xml-converter.xsl needs a redirect to: https://github.com/usnistgov/OSCAL/releases/download/v1.1.1/oscal_poam_json-to-xml-converter.xsl
  • How do I use this? : https://github.com/usnistgov/OSCAL/tree/main/xml#converting-oscal-json-content-to-xml could be replaced with: https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters

[aj-stein-nist]

Moving forward to next sprint.

[aj-stein-nist]

The issue auto-closing for the first PR was a mistake, per discussion with @Arminta-Jenkins-NIST, reopening.

[aj-stein-nist]

I finished up preparation before the sprint planning, but this is more or less done. I fixed the several errors I had not corrected as brought up by @iMichaela in #60. It should be good for final review and merge.

/cc @Arminta-Jenkins-NIST