[luv-announce] LUV Main April 2018 Meeting: Write docs like a software developer using the Linux toolchain

Andrew Pam andrew at sericyb.com.au
Sat Mar 24 22:53:48 AEDT 2018


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.

Linux Users of Victoria is a subcommittee of Linux Australia
<https://www.linux.org.au/>.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.luv.asn.au/pipermail/luv-announce/attachments/20180324/e22cacbb/attachment.html>


More information about the luv-announce mailing list