Skip to content

fix: align OSCAL version references and fix CONTRIBUTING.md typos#2141

Open
Acuspeedster wants to merge 2 commits intooscal-compass:developfrom
Acuspeedster:fix/docs-oscal-version-consistency-2135
Open

fix: align OSCAL version references and fix CONTRIBUTING.md typos#2141
Acuspeedster wants to merge 2 commits intooscal-compass:developfrom
Acuspeedster:fix/docs-oscal-version-consistency-2135

Conversation

@Acuspeedster
Copy link
Copy Markdown
Contributor

Description

fix: align OSCAL version references and fix documentation typos (#2135)
closes #2135

  • docs/index.md: update all trestle 3.x OSCAL references from 1.1.2 to 1.1.3 to match README.md and the actual OSCAL upgrade in the codebase (see CHANGELOG: 'feat: upgrade to OSCAL 1.1.3 (feat: upgrade to OSCAL 1.1.3 #1795)')
  • docs/tutorials/introduction_to_trestle.md: update stale OSCAL 1.0.4 reference to current 1.1.3
  • CONTRIBUTING.md: fix typos throughout:
    • aciton -> action in PR workflow section
    • mkbuild -> mkdocs build (correct tool name)
    • documenation -> documentation
    • Commit's -> Commits (spurious possessive apostrophe)
    • overrided -> overridden (incorrect past participle)
    • title's -> titles and an [convention commit] -> a [conventional commit]
    • Code style and formating -> Code style and formatting

Closes #2135

Types of changes

  • Hot fix (emergency fix and release)
  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Documentation (change which affects the documentation site)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Release (develop -> main)

Quality assurance (all should be covered).

  • My code follows the code style of this project.
  • Documentation for my change is up to date?
  • My PR meets testing requirements.
  • All new and existing tests passed.
  • All commits are signed-off.

Summary

This PR resolves the documentation inconsistency reported in #2135. The docs/index.md and docs/tutorials/introduction_to_trestle.md files contained stale OSCAL version references (1.1.2 and 1.0.4 respectively) that did not match the authoritative value in README.md (1.1.3) or the actual upgrade performed in the codebase (CHANGELOG: feat: upgrade to OSCAL 1.1.3 (#1795)).

CONTRIBUTING.md also contained several contributor-facing typos that could cause confusion for new contributors following the workflow documentation. All typos have been corrected.

No code changes documentation only.

Key links:

Before you merge

  • Ensure it is a 'squash commit' if not a release.
  • Ensure CI is currently passing
  • Check sonar. If you are working for a fork a maintainer will reach out, if required.

…cal-compass#2135)

- docs/index.md: update all trestle 3.x OSCAL references from 1.1.2 to 1.1.3
  to match README.md and the actual OSCAL upgrade in the codebase (see
  CHANGELOG: 'feat: upgrade to OSCAL 1.1.3 (oscal-compass#1795)')
- docs/tutorials/introduction_to_trestle.md: update stale OSCAL 1.0.4
  reference to current 1.1.3
- CONTRIBUTING.md: fix three typos:
  - 'aciton' -> 'action' in PR workflow section
  - 'mkbuild' -> 'mkdocs build' (correct tool name)
  - 'documenation' -> 'documentation'

Closes oscal-compass#2135

Signed-off-by: Acuspeedster <arnavrajsingh@gmail.com>
- 'Commit's' -> 'Commits' (spurious possessive apostrophe)
- 'overrided' -> 'overridden' (incorrect past participle)
- 'title's' -> 'titles' and 'an [convention commit]' -> 'a [conventional commit]'
- 'Code style and formating' -> 'Code style and formatting'

Signed-off-by: Acuspeedster <arnavrajsingh@gmail.com>
@Acuspeedster Acuspeedster requested a review from a team as a code owner March 11, 2026 16:25
@Acuspeedster Acuspeedster changed the title Fix/docs oscal version consistency 2135 fix: align OSCAL version references and fix CONTRIBUTING.md typos Mar 11, 2026
@Acuspeedster
Copy link
Copy Markdown
Contributor Author

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.

Inconsistent OSCAL version references and outdated onboarding documentation

1 participant