Die EclipseCon ist jedes Jahr eine große Konferenz für Entwickler, Architekten und rund um Open-Source-Technologien. Im Fokus stehen unter anderem Laufzeitumgebungen, Werkzeuge und Frameworks rund um Cloud- und Edge-Technologien.
Die msg ist in der AsciiDoc Working Group aktiv und zeigt mit dem Vortrag "Writing docs in your IDE - an AsciiDoc primer" wie Dokumentation während der Entwicklung in der IDE geschrieben werden kann.
In diesem Jahr findet die Konferenz wegen der Beschränkungen aus COVID-19 online statt. Dadurch können alle Teilnehmer kostenlos teilnehmen. Alle Vorträge der Veranstaltung werden auf Englisch gehalten.
Unser Beitrag: Writing docs in your IDE - an AsciiDoc primer
(Link: https://www.eclipsecon.org/2020/sessions/writing-docs-your-ide-asciidoc-primer)
Follow the documentation-as-code approach: Write documentation in your IDE, collaborate with other developers and writers using version control and let a continuous integration server scrutinize and publish your docs.
AsciiDoc is a lightweight markup language that translates for example to HTML and PDF. In your development environment, an IDE plugin provides editor support and preview pane. Every commit to your version control system not only enhances your program, but also your architecture, developer or user documentation.
After a short introduction to AsciiDoc this talk shows how to edit and structure content in a development environment. Live examples show how to work with the AsciiDoc in the IDE and the build process.
Referent: Alexander Schwartz