Use accessible STIX 2.1 SVG icons in documentation - #140
Open
Kevinwochan wants to merge 4 commits into
Open
Conversation
Kevinwochan
marked this pull request as ready for review
July 30, 2026 14:33
Author
|
@ejratl @adulau This PR is ready for review. It replaces ambiguous documentation PNG usage with accessible SVG and labeled variants, including refined TLP markings. Reference audits, XML validation, canonical byte comparisons, rendering checks, and the CLA all pass. When you have time, a maintainer review would be appreciated. |
Author
|
@chrisr3d Friendly follow-up on this PR. It remains ready for review and cleanly mergeable; the CLA, reference audit, XML validation, canonical comparisons, and rendering checks all pass. I’m happy to adjust the implementation if needed. Could you advise whether this repository is currently accepting contributions? |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The SVG artwork comes from the STIX 2.1 Community SVG Icons project. The labeled tiles are byte-identical to canonical source commit
14fd9b4f24df5adafbf5392e73a4a51f4214abc5; the flat compatibility SVGs preserve the historical 77-by-77 intrinsic dimensions. They are provided under this repository's BSD 3-Clause license.The labels are deterministic vector paths rather than SVG text, so rendering does not depend on installed fonts. TLP scope pictograms are original, non-normative community artwork; the applicable FIRST color and literal uppercase label remain authoritative. Consumers must also expose the complete marking name through native visible and accessible text. Labeled TLP tiles are intended for display at 96 CSS pixels or larger.
Rendered impact
The updated examples retain the TLP name, official color, and illustrative scope pictogram in screenshots and exported documents:
Validation
./audit-icon-references.sh14fd9b4f24df5adafbf5392e73a4a51f4214abc5xmllintpath[data-label]and no SVG text or font dependencygit diff --check main...HEAD