From DGFIP - SRE
I'm a Software Developer with 12+ years of experience. I'm actually the technical lead for the Individual Retirement Account (CIR) project at the French Ministry of Finance.
I'm passionate about IT and Open Source so I contribute to Open Source projects (Asciidoctor, JBoss Forge, Struts...) in different ways (coding, speaking...)
I wrote a French book about Apache Maven 3 in 2011 and, as a technical reviewer, I'm actually reviewing a book about Java EE 7 and WildFly 8. I'm speaker at conferences on Java, Web and Cloud technologies like DevNation and DevFest. I blog about all those technologies on his personal website : http://mgreau.com
By using AsciiDoc, you're already following one of the best practices we recommend. You can write once and publish everywhere!
AsciiDoc takes a lot of the pain out of writing documentation and keeps it DRY. As with any tool, you need to learn the best practices to use it effectively, such as:
- How to organize your documentation
- How to make your documentation approachable to contributors
- How to make your documentation easy to maintain
- What tools to use to simplify collaboration & maximize reuse
I'll address some of the challenges we've come across writing documentation in AsciiDoc, offer a set of tips and recommendations that have helped us improve our writing flow and provide advice about how to keep presentation from leaking into your content...and why it matters.
Let's discuss about the Asciidoctor ecosystem and more generally about the open documentation / collaboration.
Venez échanger autour de l'écosystème Asciidoctor et plus généralement sur la documentation et la collaboration.
Français ET/AND English