Alexander Schwartz
Alexander Schwartz is a Principal Software Engineer at Red Hat. He helps organizations and teams to make architecture decisions that match their needs. To build their software in a maintainable way, he empowers them with best practices, tools and libraries. He leads by example to adopt true agile processes and to stay curious. Ideas spark when sharing thoughts with others. Finding out if an idea works requires experimenting with code and UX. Measurable results of the experiment show if the idea worked out, and might lead to new experiments.
Writing docs in your IDE – an 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 a development environment, an IDE plugin provides editor support and preview pane.
Participants work in small groups using a web-based collaborative editor or their local IDEs. With small katas they will learn how to format text, structure documents, use images and embed diagrams. The workshop closes with a Q&A session to share best practices that participants can apply to their projects.