Skip to content

CSAF 2.1 CSD02 Public Feedback Resolution and Editor Revision (for TC meeting 2026-04-29)#1399

Merged
sthagen merged 94 commits into
masterfrom
editor-revision-2026-04-29
May 22, 2026
Merged

CSAF 2.1 CSD02 Public Feedback Resolution and Editor Revision (for TC meeting 2026-04-29)#1399
sthagen merged 94 commits into
masterfrom
editor-revision-2026-04-29

Conversation

@tschmidtb51

@tschmidtb51 tschmidtb51 commented Apr 25, 2026

Copy link
Copy Markdown
Contributor

Content Changes

Editorial Changes

Maintenance Changes

  • Maint: asterisk and dash cleansing # 1453

Tool Changes

Test Files Changes

- update dates
- insert new revision for tracking
- update pdf generation metadata
- update to CSD03 where applicable
- addresses parts of #1396
- created draft comment log
- added issues to comment log
- resolves #1365
- correct spelling mistake
- additionally correct format mistake
- addresses parts of #1396
- add solution to comment resolution log
@tschmidtb51
tschmidtb51 requested a review from sthagen April 25, 2026 22:02
@tschmidtb51 tschmidtb51 self-assigned this Apr 25, 2026
@tschmidtb51 tschmidtb51 added editor-revision already worked on in the editor revision csaf 2.1 csaf 2.1 work labels Apr 25, 2026
- addresses parts of #1396, #1372
- add missing announcement from mailing list
-
- fix typos in comment resolution log
- resolves #1370
- add comment that behavior changed between CSAF 2.0 and 2.1 regarding fix length and open ended
- addresses parts of #1396
- add solution to comment resolution log
@tschmidtb51 tschmidtb51 changed the title Editor revision for TC meeting 2026-04-29 CSAF 2.1 CSD02 Public Feedback Resolution and Editor Revision (for TC meeting 2026-04-29) Apr 27, 2026
@tschmidtb51 tschmidtb51 added the oasis_tc_process OASIS TC process action label Apr 27, 2026
tschmidtb51 and others added 14 commits April 27, 2026 14:25
- addresses parts of #1396
- add pull request of Comment Log
- resolves #1371
- rephrase sentence to avoid usage of `ValidTLPLabel`
- clarify which labels are valid (those from CSAF 2.1 JSON schema)
- fix formatting
- addresses parts of #1372
- replace "information" with "warning"
- add path requirement to error as well
- addresses parts of #1372
- remove specialized warnings covered by general rule
- fix formatting
- addresses parts of #1372
- deal with multiple valid SPDX license expressions
- Fixed typos (link markup errors)
- reduced 'the the' to 'the'
- simplified English (listed instead of reflected)
- some small opinonated changes ;-)
- Fixed duplicated every occurence
- Simplified English
- Observation: We mix SHALL and MUST in exotic way around here ...
- addresses parts of #1372
- update text to use same wording for converters
- unify phrases to align between converters
- addresses parts of #1374
- clarify handling of unicode as comment
- addresses parts of #1374
- add invalid example
- add valid examples
Co-authored-by: tschmidtb51 <65305130+tschmidtb51@users.noreply.github.com>
tschmidtb51 and others added 6 commits May 14, 2026 02:28
- addresses parts of #1405
- update extension to use outline format in `full_product_name_t`
- addresses parts of #1405, #1432
- update outline for CVSS
- update part names of vers
- resolves #1449
- add SHELL variable
- render delivery items
@tschmidtb51 tschmidtb51 linked an issue May 15, 2026 that may be closed by this pull request
Fixed #1421 - simplified revision history section
- correct broken reference
- correct broken outline
@tschmidtb51
tschmidtb51 requested a review from sthagen May 15, 2026 09:29
@tschmidtb51
tschmidtb51 force-pushed the editor-revision-2026-04-29 branch from c1f6781 to 4fb23ff Compare May 15, 2026 09:30
@tschmidtb51
tschmidtb51 marked this pull request as ready for review May 15, 2026 09:31
@tschmidtb51 tschmidtb51 added the motion This item has a motion pending label May 15, 2026
@tschmidtb51

tschmidtb51 commented May 15, 2026

Copy link
Copy Markdown
Contributor Author

Motion set and seconded: https://groups.oasis-open.org/discussion/motion-for-1399

I hereby submit the following motion and request that if seconded and no objection received per this list before one week has passed on 2026-05-22 12:00 UTC to automatically carry.
The Chair usually states the result per mail to this list when the period has passed.

…dapted markdown lint config

Signed-off-by: Stefan Hagen <stefan@hagen.link>
@sthagen

sthagen commented May 17, 2026

Copy link
Copy Markdown
Contributor

Incoming change set in:

  • "Maint: asterisk and dash cleansing" # 1453 has been included.

If we would have forgotten, we could have applied before the next editor revision easily ...

PS: inside csaf_2.1/prose/edit ... do 1.:

if [ "$(uname)" = 'Darwin' ]; then quux="''"; else quux=''; fi;
for f in src/*.md; do \
  sed -i ${quux} \
  "s/^\*\ /- /g; s/^\ \ \*\ /  - /g; s/^\ \ \ \ \*\ /    - /g; s/^\ \ \ \ \ \ \*\ /      - /g; " \
  $f; done
for f in $(grep "^-------" src/*.md | cut -f1 -d:); do \
  sed -i '' "s/^-------/---/g;" \
  $f; done

and finally 2. edit etc/markdownlint.json:

diff --git a/csaf_2.1/prose/edit/etc/markdownlint.json b/csaf_2.1/prose/edit/etc/markdownlint.json
index eeb14631..e504b8a3 100644
--- a/csaf_2.1/prose/edit/etc/markdownlint.json
+++ b/csaf_2.1/prose/edit/etc/markdownlint.json
@@ -14,7 +14,7 @@
     "style": "atx"
   },
   "hr-style": {
-    "style": "-------"
+    "style": "---"
   },
   "line-length": false,
   "link-fragments": false,
@@ -55,6 +55,6 @@
     "style": "asterisk"
   },
   "ul-style": {
-    "style": "asterisk"
+    "style": "dash"
   }
 }

@justmurphy justmurphy left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

lgtm

@sthagen
sthagen merged commit 613e8fb into master May 22, 2026
18 checks passed
@tschmidtb51 tschmidtb51 added motion_passed A motion has passed and removed motion This item has a motion pending labels May 27, 2026
@justmurphy

Copy link
Copy Markdown
Contributor

Motion passed 5/22 and merged on 5/27 during TC meeting: https://groups.oasis-open.org/discussion/motion-for-1399

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment