Technical writing with Continuous Integration and docs-as-code
Sneaking a peek at the numbers for documentation along with the code should show us pointers about docs keeping up with code. As I suspected, there were about three major contributors to the operations manuals that span all the projects, and about three major contributors to the API docs. Also not a big surprise, I […]
Glad you asked! The site at http://api.openstack.org is a collection of HTML pages, and one page has an especially interesting story about how it is built. The http://api.openstack.org/api-ref.html page provides a listing of all the API calls for all OpenStack APIs that contribute docs to the page. Currently the only API that is still a […]
I constantly try to network locally with Austinites, and I’m meeting more tech writers with diverse backgrounds. One of Austin’s slogans is “Keep Austin Weird” and while our writers aren’t necessarily weird, their backgrounds can be! For example, I know of one award-winning novelist in Austin who writes manuals during the day and novels at […]