Seja a primeira pessoa a gostar disto
In this talk the speaker explains and demonstrates popular tools and platforms for writing and publishing technical documentation, such as developer's guides, technical books, API documentation and technical tutorials, along with his personal experience from the last 15 technical books published online using such tools.
Toolchains for building beautiful, flexible and searchable documentation like gitbook-cli, MkDocs and Sphinx are discussed and demonstrated, along with platforms like Read The Docs (readthedocs.org) and GitBook (gitbook.com).
In a live demonstration, the speaker shows an example how to write an open-source technical book in GitHub, using Markdown articles, compiled into a single online book using the "gitbook-cli" static site generator and how to publish the book in GitHub Pages. A special attention is given to more advanced techniques like embedding videos and live code examples (with [Run] button) in a smart way in Gitbook books.
Learn more at https://github.com/beerjs/sofia, https://nakov.com.