1. Summary

Documentation as Code (doc-as-code)

2. Asciidoc

Asciidoc

Linguagem de marcação (Markup Language) para escrever documentos

  • eBooks (ex: PDF, EPUB)

  • Documentação (ex: Reference, REST Api, Guides)

  • Apresentação (slideshow) gerado via (Reveal.js)

Runtimes

  • AsciiDoctor (Ruby) implementation de AsciiDoc

  • AsciiDoctorJ (Ruby to Java: Ruby port)

  • AsciiDoctor.Js (Ruby to Javascript: OPAL port)

Editor

  • AsciidocFX

Quem usa AsciiDoc

  • Pivotal Documentação Spring Framework

  • Red Hat Documentação Openshift

  • Neo4J Documentação

  • O’Reilly projecto Atlas

  • Github github.com, Gitbook.com

3. JAMstack

JAM

JavaScript, API and Markup

4. Reference