Feature request: recognise .adoc (AsciiDoc) for Community Standards health files #189645
Replies: 1 comment
-
|
Hi hyperpolymath 👋 +1 — excellent feature request! This is exactly the kind of small-but-impactful improvement the AsciiDoc community has been waiting for. GitHub already renders
Projects that standardise on AsciiDoc (Fedora, Spring, Eclipse Foundation, Asciidoctor ecosystem, many enterprise repos, etc.) are forced to maintain duplicate Why this should be prioritised
Current workaround (until implemented)Keep both versions side-by-side or accept an incomplete health score — neither is ideal. GitHub team — this one is a no-brainer. It aligns perfectly with your existing AsciiDoc support and would make thousands of repos happier instantly. Upvoted and following! 🚀 Anyone else using AsciiDoc as their primary format? Drop a 👍 below so we can show the demand. |
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
-
Summary
GitHub's Community Standards tab (the "Community profile" checklist on a repo's Insights page) currently only recognises
.md(Markdown) files for community health indicators like CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, etc.Repositories that use AsciiDoc (
.adoc) — which GitHub already renders beautifully — are penalised in the community health score because the platform doesn't detect their.adocequivalents.The ask
Please extend the community health file detection to recognise
.adocalongside.mdfor:CONTRIBUTING.adocCODE_OF_CONDUCT.adocREADME.adoc(already works for rendering, but not always for health checks)SECURITY.adocSUPPORT.adocWhy this matters
AsciiDoc is widely used in enterprise, documentation-heavy, and standards-oriented projects. Many projects (Fedora, Spring, Asciidoctor ecosystem, Eclipse Foundation projects) standardise on
.adocbecause of its richer feature set (includes, cross-references, conditional content, callouts).Forcing these projects to maintain duplicate
.mdfiles purely for GitHub's community health checklist is unnecessary friction — especially since GitHub already has full AsciiDoc rendering support.Current workaround
Maintain both
.mdand.adocversions of the same files, or accept an incomplete community health score. Neither is ideal.Thank you for considering this — it would be a small change with outsized impact for the AsciiDoc community.
Beta Was this translation helpful? Give feedback.
All reactions