All Posts

A thumbnail image

Publishing Docs as Code

Concluding a delve into docs as code… If you wanna publish chosen articles to Medium without the tedium, Part 3, this how-to guide can help you.

A thumbnail image

How To Post To Medium Without The Tedium

You’ve got a Markdown build pipeline and you wanna publish to Medium without the tedium! If you wanna publish a chosen article to Medium, not an entire static site, this how to is for you.

A thumbnail image

Analysing A Docs As Code Pipeline

The Hemingway Editor says that sentence is: hard to read (yellow highlight), and; uses passive voice (green highlight). As an noob writer, I frequently make those mistakes, so that kind of feedback really helps me.

A thumbnail image

Docs-as-code Build Pipeline Explained: From Crazy to Consistent

Here’s an example docs-as-code build pipeline. It describes a process for checking and testing documentation written in markdown format. After committing and pushing markdown changes to Github, the pipeline will run.

A thumbnail image

How To Create a Docs as Code Build Pipeline

Before you publish written content, you wanna check spelling, lint markdown, improve prose, and fix broken links. This approach uses a builder image specialised for your docs-as-code workflow.

A thumbnail image

Creating A Docs As Code Pipeline

Have you thought about managing docs as code? Before you publish written content, you wanna check spelling, lint markdown, improve prose, and fix broken links. The idea of docs-as-code is to version control, build, test, and deploy your documentation using pull requests, continuous integration and continuous deployment.