Update security terminology to emphasize curated output approach#77
Update security terminology to emphasize curated output approach#77
Conversation
Co-authored-by: danmarshall <11507384+danmarshall@users.noreply.github.com>
|
@copilot I (personally) don't even think of "rejection" - as in "you came but i didnt let you in" but more of "i didnt even mail you a ticket". |
Co-authored-by: danmarshall <11507384+danmarshall@users.noreply.github.com>
Updated in 9ed538e. The terminology now emphasizes that Treebark produces curated output - like Rolls Royce starting with select quality materials, not considering bubblegum in the first place. Unsafe tags/attributes/patterns are now described as "not recognized" rather than "rejected" or "blocked", since they never make it to the evaluation stage. Exception: Prototype chain properties ( |
Documentation used blocking/blacklist terminology when describing security features. The library implements an allowlist architecture where only a curated set of safe tags and attributes are recognized—like Rolls Royce selecting quality materials rather than rejecting unsuitable ones.
Changes
Updated terminology across documentation files to accurately reflect the curation model:
Files Modified
spec.mdREADME.mddocs/index.mdnodejs/packages/markdown-it-treebark/README.mdExample
Before:
After:
The updated language emphasizes what is curated and selected rather than what is rejected. Unsafe elements aren't evaluated and blocked—they're simply not part of the consideration set. The security model is one of careful selection, not rejection.
Rationale
The distinction matters: In a true allowlist model, dangerous elements like
<script>aren't "rejected" (implying they were considered and refused). They simply aren't on the curated list of recognized elements—they never "get a ticket" in the first place. This philosophical difference is now reflected in the documentation.Original prompt
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.