Subscribe to our Erlang Factory newsletter to receive the latest updates and news

Andy Oram
Editor at O'Reilly Media
O'Reilly Media

Andy Oram is an editor at O'Reilly Media, a highly respected book publisher and technology information provider. An employee of the company since 1992, Andy currently specializes in open source, software engineering, and health IT, but his editorial output has ranged from a legal guide covering intellectual property to a graphic novel about teenage hackers. His work for O'Reilly includes the influential 2001 title Peer-to-Peer, the 2005 ground-breaking book Running Linux, and the 2007 best-seller Beautiful Code.

Andy also writes often for O'Reilly's Radar site and other publications on policy issues related to the Internet and on trends affecting technical innovation and its effects on society. Print publications where his work has appeared include The Economist, Communications of the ACM, Copyright World, the Journal of Information Technology & Politics, Vanguardia Dossier, and Internet Law and Business. Conferences where he has presented talks include O'Reilly's Open Source Convention, FISL (Brazil), FOSDEM, and DebConf. 

Twitter: @praxagora

Andy Oram is Giving the Following Talks
Taking Documentation to the Next Level in Young Software Projects

Most free software projects, as well as companies releasing APIs or other software, want to provide good documentation to attract and support developers and users. With reference to a few examples from online Erlang documentation, this talk suggests why it's so hard to create usable documentation and discusses some directions to go in, such as finding users who can write helpful documents, checking quality through A/B testing, and providing pathways through documents.  The focus will be on documentation for programmers, because resources for such documentation are very limited, but anything that aids wider adoption can foster innovation.

Talk objectives: 
1. Get the audience thinking more about the role of documentation and training in their own software projects.
2. Encourage the audience to take steps to improve the documentation for the programmers who use their software.

Target audience: Anyone who participates, as a developer or user, in a software project that delivers libraries or tools to outsiders