Whether you’re just rolling out a new project, or you’re maintaining ten years and three major versions of legacy code, good documentation is vital for your users. But writing good docs doesn't need to be a long, painful process. This talk will get you started - and finished! - in no time.
Whether you’re just rolling out a new project, or you’re maintaining ten years and three major versions of legacy code, good documentation is vital for your users. But even when you know it’s necessary, come on, who wants to actually write docs? It takes too long, and it’s no fun anyway.
Writing docs doesn’t have to be a bore. This presentation give you all the tips and tools to create great docs quickly. From first drafts to final revisions, it’s all in here – we’ll discuss how to get started, how to build on what you already have, and even some ideas for attracting volunteers to help document your project.
And, getting involved with documentation is a great way to contribute back to your favourite project. It’s easy to get going, and a great way to get appreciated! If you know how to use the software to do what you want, you’re ready to go. The most important thing is being how to explain what you’re doing – but we’ll also take a look at some of the commonly-used tools of the trade.
So if your favourite project’s documentation is not quite there yet (and let’s face it, whose is?!), this talk is for you. From her early days in Open Source, contributing drive-by translations and docs to projects she was using, to her work as a technical writer at Google, to her recent experience writing four books in three days (no really!), Noirin’s wealth of experience will help you get going from wherever you stand.