Technical writing with Continuous Integration and docs-as-code
Sometimes treating docs as code seems overly complicated. Let’s break it into component parts – static site generators, development environments, source control, continuous integration, hosting, deployment, and testing docs. Yes there is a stack here to learn, but now you can take tutorials one-at-a-time no matter where you are in a docs-as-code exploration. Go to […]
When you treat docs like code, you want to deploy that “code” to a web site. In our case, these code source files are doc source files. We want to see how something like a documentation site looks on a web site with a static site generator (SSG) like Jekyll. I had been practicing these […]
I’ve been thinking a lot about developer support at Cisco recently, especially for the way the world works today with multiple cloud providers. This post is a re-publish of my talk from over five years ago, but the techniques and tools for listening and helping others are still true today. At Rackspace, we watched several […]