Your current filters are…
by Phil Jackson
An extensive API is quickly becoming a necessity for all service providers. However, simply having one is not enough. In this talk, Phil reveals some of the pitfalls experienced while becoming the new Developer Advocate for SoftLayer, and how he has tried to climb out of them while balancing customer needs and Drupal development.
Read the Docs is a documentation hosting site for the community. It was built in 48 hours in the 2010 Django Dash. In January 2010 it had 100,000 page views, and increases daily. I will talk about all of the code to deploy and run a sizable Django site. We will go through the highlights and interesting parts of the code, as well as some of the lessons learned from the site being open source.
Web API documentation is a necessity for the success of a platform. Developers need docs to learn how to utilize your resources. Providing poor documentation is often considered worse than no documentation at all (which is inexcusable).
Why do so many companies fail at providing great docs? What are the trends in the API universe when it comes to web API docs?
Neil will discuss the trend of interactive API documentation, and how it helps platform providers maintain docs more easily, keep docs examples fresh and up to date, and provide an interactive learning environment that is clean and concise.
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. They won't bother downloading your software if they can’t work out what it does, and if all you have is the bare-bones documentation to help them to get up and running, you’ll end up spending more time than you want to on support.
25th–29th July 2011