Check out Uniting API documentation and code: InfoQ article by annegentle. Here is an excerpt:
At the beginning of this year, I worked hard to summarize my thoughts on API documentation, continuous publishing, and technical accuracy for developer documentation. The result is an article on InfoQ.com, edited by Deepak Nadig, who also was forward-thinking in having me speak to a few teams…
The full article is available here.