When faced with tough problems, don’t stop working, try new things, and achieve your docs-as-code dream.
What does it take to publish a technical book using GitHub? Let’s dig into tools, processes, revenue, and costs.
Changing from a content management system to Jekyll and all the change that undertaking took.
In the last three years of Write the Docs conferences, you can learn from others experiences using docs like code techniques.
At Rackspace, we recently modernized our customer documentation, implementing a model that treats documents like code.
From Mandy Whaley’s presentation at All Day DevOps 2017.
Anne Gentle, the original wiki aficionado from the mid-2000s, discusses their relevance today.
Diána Lakatos, a technical writer with developer portal creation specialists Pronovix, explores free and open source API documentation solutions. Her compiled results of the research were originally posted on the Pronovix blog.
Integrating Swagger/OpenAPI files from code with documentation.
Give list pages a makeover using Hugo, a static site generator, with source files on GitHub from Leon Barnard, Designer and Writer at Balsamiq.
Learn how to play and pause animated GIFs on static sites such as Hugo on GitHub from Leon Barnard, Designer and Writer at Balsamiq.
Learn useful techniques for static sites such as Hugo on GitHub from Leon Barnard, Designer and Writer at Balsamiq. He describes documenting multiple versions of a product with a Go coded solution.
Jennifer Rondeau, Technical Writing Manager at Capital One, talks about her experiences as a Principal Information Developer at Symantec integrating code and documentation tightly.
In this use case, the Technical Content Editor at Pantheon, Rachel Whitton, describes their use of GitHub for documentation on a platform for WordPress and Drupal.
What do you want to know about these techniques?
Make sure you have a punch list of doc bugs to get higher quality results.
Let’s look at a live example.
What do you do when people say, ‘The Docs Suck.’?
When you work with others, your deliverables win.
What would happen if we treated docs like code?