This time we decided not to have a presentation, but a discussion in a relaxed bar atmosphere. We met at "Kulturkneipe" in a culture center in Bonn Beuel, which is usually frequented by cinema goers and theater folks. Nine people showed up, and we split up into two groups to allow everyone to take part more actively in the discussion.
We prepared a Q&A card game based on the book "Dokumentation in agilen Projekten" (Documentation in agile projects) by Andreas Rüping. Each card represented a pattern described in the book, a typical problem with a suggestion how to solve it with proper documentation. Playing the game took about two hours and triggered an interesting exchange of perspectives and ideas.
Here's a short list of links of tools that came up during the discussion
- high quality information about the art of writing documentation: http://docs.writethedocs.org/
- Wiki Patterns - Best Practices for wiki use and adoption: https://wiki.base22.
com/display/btg/Wiki+Patterns+ -+Best+Practices+for+wiki+use+ and+adoption
- Free and simple documentation hosting: https://readthedocs.org/
- Generate Word documents from Confluence http://www.viaboxx.de/code/confluence2md/
- Screenshots, Doku generieren und GUI Tooling für HTML apps http://www.viaboxx.de/
- Die ältere Variante, für Flash/Flex apps http://www.viaboxx.de/
- Build beautiful APIs - Collaborative design, instant API mock, generated documentation, integrated code samples, debugging and automated testing. http://apiary.io/
- GitBook is a tool for building beautiful books using Git and Markdown. It can generate your book in multiple formats: PDF, ePub, mobi or as a website. http://gitbookio.gitbooks.io/documentation/
Please keep an eye on our Twitter channel to get information on the next meetup, or subscribe to the mailing list!
Gestern sehr interessantes #bonn #agile Meetup zum Thema #Dokumentation. Dank an @bonnagile & @sustainablepace, wir haben viel gelernt!
— Data in Transit GmbH (@dataintransit) December 3, 2014
Big thanks to @sustainablepace for yet again providing the @bonnagile meetup with an original and discussion-worthy topic!
— Thomas F. Nicolaisen (@tfnico) December 2, 2014