AsciiDoc Language issueshttps://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang/-/issues2023-02-28T01:34:16Zhttps://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang/-/issues/12Create an abridged syntax quick reference2023-02-28T01:34:16ZSarah WhiteCreate an abridged syntax quick reference*Issue origin: https://github.com/asciidoctor/asciidoc-docs/issues/58*
*Published page: https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/*
*Source page: https://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lan...*Issue origin: https://github.com/asciidoctor/asciidoc-docs/issues/58*
*Published page: https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/*
*Source page: https://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang/-/blob/main/docs/modules/ROOT/pages/syntax-quick-reference.adoc*
Although an invaluable resource, the syntax quick reference is not so quick. We should consider making a one page document, perhaps using a different layout, that tries to present the AsciiDoc syntax in the most concise way possible. There are many such attempts floating around, so we can probably build on prior work to slim it down. If we do make this page, we may want to consider reclaiming the the existing page name and moving that one to a detailed syntax reference.
We might think about this being "AsciiDoc essentials" or "the most common AsciiDoc you need to know to be productive". It should not be a full reference (like the current syntax quick reference). It should just highlight the most common features a writer will use day to day.