https://luv.asn.au/2018/04/03

PLEASE NOTE NEW LOCATION

Tuesday, April 3, 2018

6:30 PM to 8:30 PM
Kathleen Syme Library, 251 Faraday Street Carlton VIC 3053

Speakers:

• Alec Clews, Write docs like a software developer using the Linux toolchain

This talk is about public API documentation and what useful developer documentation should look like. The bulk of the presentation will demonstrate various UNIX/Linux style CLI tools (M4, Make, Plantuml, Pandoc, Graphviz, ...) and how they can be part of a build chain to keep your docs up to date and relevant. There will also be a discussion on why this toolchain is used, instead of tools like Javadoc or Swagger.

The material is based on a short talk given at LCA 2018 'Using "old skool" Free tools to easily publish API documentation'

Alec Clews founded Melbourne Raspberry Jam. He can be found online as alecthegeek in to many places. He drinks too much espresso, uses Linux as much as possible and wishes he was a better Go programmer.