Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[2.0] spec review: must --> shall

Open
#1,033 5 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@jkowalleck is already working on this.

Since Aug 24, 2026.

Assessment

This issue has not been assessed yet.

Description

CDX 2.0 defect documentation

THe CycloneDX 2.0 schema will be transferred into Ecma-242, 3rd edition.

Per Ecma guidelines, the word "must" should not be used, instead the word "shall" should be used. - as mentioned by @gesa .
(except when it comes to legal stuff - as mentioned by @mjherzog)

  • we need to review the textual part of the schema 2.0 to not use "must", but use "shall".
  • are there other such phrasing rules?

I think we have a linter tool that could find all "must".

Dominant language
XSLT
Stars
551
Forks
93
Avg merge
5h 38m
Merged PRs (30d)
35

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from CycloneDX/specification

All issues in CycloneDX/specification

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.