Re: [luv-announce] LUV Main April 2018 Meeting: Write docs like a software developer using the Linux toolchain
On Sat, Mar 24, 2018 at 10:53:48PM +1100, luv-announce wrote:
*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/>.
Not too far from Maria's eh? Anyone else care to comment? Cheers ... Duncan.
hi a block and a half from the central Lygon Street food district 200m walk to half a dozen places On 25/03/18 16:39, Duncan Roe via luv-main wrote:
On Sat, Mar 24, 2018 at 10:53:48PM +1100, luv-announce wrote:
*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/>.
Not too far from Maria's eh?
Anyone else care to comment?
Cheers ... Duncan. _______________________________________________ luv-main mailing list luv-main@luv.asn.au https://lists.luv.asn.au/cgi-bin/mailman/listinfo/luv-main
participants (2)
-
Duncan Roe -
Steve Roylance