[Linux-aus] Writing Openly; Open Source Documentation Miniconf at Linux.conf.au 2015

[Simon Lyall]

People often complain about the quality of open source project
documentation. At the same time, documentation is a great place to get
started contributing to an open source community.

This miniconf will explore practical aspects of Open Source documentation,
with an eye to applying them right away.

We will look at:

   - popular markup languages (Docbook, DITA, markdown, etc)
   - version control systems for writers (SVN, git, etc)
   - getting started as a contributor (how to pick a project, getting an
   account, meeting the community, your first commit, etc)
   - documentation skills and methodologies (topic-based authoring, single
   sourcing, minimalism, etc)

We'll then be able to start contributing documentation. The pacing of this
session will be largely driven by participant interest. It might be that we
fly through the concepts straight to a frenetic docs hack fest. It might be
that we get a lively argument about the best markup language, or whether
minimalism is all hype.

Tim Hildred was a technical writer at Red Hat. Before that a barista at the
Linuxcaffe in Toronto

 Linux.conf.au

linux.conf.au is one of the foremost open source conferences in the world,
and is considered the most prestigious in the Southern Hemisphere. The next
conference, LCA2015, will be held on 12 - 16 January 2015 at the University
of Auckland in Auckland, New Zealand.
Linux.conf.au Miniconfs

Miniconfs are one day miniature conferences, within the main LCA2015
conference, which are targeted towards specific communities of interest and
offer delegates an opportunity to network with other enthusiasts while
immersing themselves in a specific topic or project.

LCA2015 miniconfs will be run on Monday 12th and Tuesday 13th of January
2015. Each miniconf's schedule is organised by the miniconf's organiser and
will be published ahead of time, listing speakers and sessions for the day.
Linux.conf.au 2015 Date: 12 - 16 January 2015
Venue: Owen G Glenn Building, University of Auckland, Grafton Road,
Auckland.
City: Auckland, New Zealand
Web: http://linux.conf.au/
Facebook: https://www.facebook.com/LCA2015
Twitter: @linuxconfau
Hashtag: #lca2015
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.linux.org.au/pipermail/linux-aus/attachments/20140920/a062d0e2/attachment.htm