These resources pertain to the standardization and specification of the AsciiDoc language itself:
- AsciiDoc Top-Level Project
-
Official Eclipse Foundation project page. Provides governance structure, project scope, and Working Group information.
- AsciiDoc Working Group Charter
-
Formal charter defining the mission, scope, and governance of the AsciiDoc Working Group. Essential reading for understanding the official goals of standardization.
- AsciiDoc Language GitLab Group
-
Parent group hosting all Eclipse Foundation repositories related to AsciiDoc language standardization.
- AsciiDoc Language Specification Repository
-
Official repository for the AsciiDoc Language Specification, Abstract Semantic Graph (ASG), Document Object Model (DOM), and extension SPI. This is the source of truth for what constitutes valid AsciiDoc syntax and semantics.
- AsciiDoc Technology Compatibility Kit (TCK)
-
Test suite for verifying that AsciiDoc processors conform to the specification. Any processor claiming AsciiDoc compatibility should pass the TCK.
|
Tip
|
If you’re implementing a new AsciiDoc processor or contributing to standardization discussions, start with the Language Specification and TCK repositories. |
These resources pertain to Asciidoctor, the reference implementation of AsciiDoc written in Ruby:
- Asciidoctor GitHub Repository
-
Main repository for the Asciidoctor processor (Ruby). This is where development, issues, and contributions for the Ruby implementation happen.
- Asciidoctor Documentation
-
Comprehensive user documentation for writing AsciiDoc documents and using the Asciidoctor toolchain. While it documents the Asciidoctor implementation, most syntax information applies to AsciiDoc in general.
- Asciidoctor News (archived)
-
Historical project announcements and release notes for Asciidoctor. Note: This news feed is no longer actively updated. For current updates, follow the GitHub repository releases or join the Zulip chat.
|
Note
|
Asciidoctor documentation often serves as a de facto reference for AsciiDoc syntax because it is comprehensive and actively maintained. However, for formal standardization questions, consult the Eclipse Foundation Language Specification. |
- AsciiDoc Language Chat (Zulip)
-
Primary communication channel for discussions about the AsciiDoc Language Specification, standardization efforts, and Eclipse Foundation Working Group activities. Use this for:
-
Questions about the language specification
-
Proposals for language changes or clarifications
-
TCK development and conformance testing
-
Working Group coordination
-
- Asciidoctor Discussion Forum (archived)
-
Historical discussion forum for the Asciidoctor community. Now archived but remains accessible for reference. Active discussions have moved to Zulip.
|
Tip
|
For real-time help and community engagement, use the Zulip chat. For historical context or past discussions, consult the archived forum. |