Writing Openly; Open Source Documentation Miniconf at Linux.conf.au 2015
Submitted on 2014-09-19 20:29
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 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.
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 2015Date: 12 - 16 January 2015
Venue: Owen G Glenn Building, University of Auckland, Grafton Road, Auckland.
City: Auckland, New Zealand