|
|
[comment]: <> (REVIEW maybe it makes sense to state that this is the concent of the page, the overall TOC is on the right side)
|
|
|
|
|
|
[[_TOC_]]
|
|
|
|
|
|
|
... | ... | @@ -21,7 +23,7 @@ |
|
|
|
|
|
## ASAM Document Language & Formats
|
|
|
|
|
|
- All ASAM OpenX Standards are written using the Asciidoc format
|
|
|
- All ASAM OpenX Standards are written using the Asciidoc format [asciidoc Homepage](https://asciidoc.org/)
|
|
|
|
|
|
- AsciiDoc is a mature, plain-text writing format for authoring notes, articles, documentation, books, ebooks, web pages, slide decks, blog posts, man pages and more.
|
|
|
|
... | ... | @@ -31,9 +33,10 @@ |
|
|
|
|
|
**Main advantages:**
|
|
|
|
|
|
- Openable in any text editor
|
|
|
- Can be edited in any text editor or using the online editor in Gitlab
|
|
|
- Focus on content not on formatting!
|
|
|
- Versionable and diffable – i.e. we can tell who did what, when and where!
|
|
|
- In the end we can deliver an interactive html instead of a static pdf
|
|
|
|
|
|
|
|
|
>See the [AsciiDoc Guide](/docs/other-guides/Asciidoc-Guide) for a guide on writing Asciidoc.
|
... | ... | |