Technical writing with Continuous Integration and docs-as-code
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 like to point people to GitHub Pages when they want to learn Git. How about three options for learning Git and GitHub with doc projects?
Leon Barnard from Balsamiq wrote up a great series of challenges and solutions for the docslikecode.com website. His lessons learned are super helpful for all of us: Challenge #1: Documenting multiple product versions Challenge #2: Adding play/pause to animated GIFs Challenge #3: Giving the list pages a makeover He summarizes the series best in his […]