Effectively Managing Documentation for Open-Source Projects
Documentation is a vital user-facing component of all serious projects, open-source and otherwise, but it is often overlooked—-or, worse, dealt with in fire-drill mode just before going to manufacturing or market. However, documentation is a project’s backbone. It is often what users and OEMs see first, and it is also the place you want users to look when they have questions or problems (so they don’t have to call you).
Making documentation approachable is a non-trivial task. Like the finish on a restored car or a piece of fine furniture, it can make a clunker look like a million bucks, or it can put your diamond irretrievably in the rough. This short presentation addresses the process of managing the documentation portion of your project, with special attention paid to open-source issues as well as those of community-based development. Subjects include internal project documentation, published APIs and their accompanying SDKs, and end-user documentation, and the four critical issues that must be addressed in each component.
People planning to attend this session also want to see:
Jeffrey Osier-Mixon
Intel Corporation
Jeff Osier-Mixon is a technical writer, developer advocate, and community manager at MontaVista Software LLC, a market leader in embedded Linux. Jeff blogs about open source issues at http://jefro.wordpress.com (Jeff’s Open Source Resource).
Comments on this page are now closed.
Sponsorship Opportunities
For information on exhibition and sponsorship opportunities at the conference, contact Sharon Cordesse at scordesse@oreilly.com
Download the OSCON Sponsor/Exhibitor Prospectus
Media Partner Opportunities
Download the Media & Promotional Partner Brochure (PDF) for information on trade opportunities with O'Reilly conferences or contact mediapartners@ oreilly.com
Press and Media
For media-related inquiries, contact Maureen Jennings at maureen@oreilly.com
OSCON Newsletter
To stay abreast of conference news and to receive email notification when registration opens, please sign up for the OSCON Newsletter (login required)
OSCON 2.0 Ideas
Have an idea for OSCON to share? oscon-idea@oreilly.com
Contact Us
View a complete list of OSCON contacts
O'Reilly Home | Privacy Policy | Contact Us | Sitemap | conf-webmaster@oreilly.com
© 2010, O'Reilly Media, Inc. | (707) 827-7000 / (800) 998-9938
Comments
Jeff ran a great presentation. I had been hoping for some insight into effectively handling generated documentation (e.g. Javadocs) and the like. Jeff talked about the why, what, and how of documentation, more for technical writers and managers.
Though it wasn’t what I was looking for, I still found it valuable and useful.