Behind DocOps Architecture is Huw Coverdale Jones, a technical writer of six years' experience, with a specialty in docs-as-code toolchains and static documentation websites. DocOps Architecture handles documentation from writing to publishing, with the end result being a self-updating static documentation site based on CI/CD pipelines. Huw works worldwide, and can work with various software teams around the world.
Formerly of
Tern Systems
GraphAware
Kaptio
Available
Worldwide
Services
01
Everything is covered: general user manuals, guides for installation and upgrading of software, user-facing tutorials, release notes, API reference pages, and internal documentation from style guides to onboarding materials. I work directly with engineering teams to ensure accuracy and fit my documentation pipelines into the existing build chain.
02
Using the documentation site generator tools Antora and Docusaurus, I'm able to create multi-version sites, fitting the client's brand identity. Through this, I can also implement a fast, simple, and easily navigated site, which is cheap to host due to its docs-as-code nature.
03
I also construct the CI/CD pipelines for documentation, creating automated site build chains which update on git push or merge. I can also set up preview sites for the sake of review and editing. I can achieve this with the inbuilt CI/CD tools from GitHub, GitLab, and Bitbucket.
04
I am also familiar with migrating from Confluence, Word or other systems into AsciiDoc or Markdown, for use with the site generators. I can audit and review documentation as I go, analysing weaknesses, identifying missing information, and setting priorities for documentation updates.
Tools & Technologies
My docs-as-code system can slot into your existing system, fitting into your existing repositories and build chain. I can assess the best publishing toolchain to apply, and work with your engineering teams to set up a working pipeline.
Specialties
Drop me an email to set up a call or audit, and I can let you know if we can move forward from there.