About the Codewriter

My name is Brian Dominick. I make, teach, and use powerful documentation development environments in support of forward-thinking product teams.

nolabel
Figure 1. Brian Dominick presents Codewriting and LiquiDoc to the Write the Docs conference in Portland, May 2017

After two and a half years of reinventing docs at Big Data startup Rocana (acquired by Splunk), I was eager to work docs magic at new organizations. Now I run a consultancy (Codewriting, LLC) making docs-as-code dreams come true for product-focused engineering outfits. If you have an exciting project with challenging internal and user-facing documentation needs, let’s talk.

Like DevOps for docs, I specialize in documentation tooling and workflows for maximum accuracy and currency of complicated documentation projects, tying engineers, technical writers, and third-party developers together with collaborative solutions.

My forthcoming book Codewriting lays out the new fundamentals of this practice, sometimes called DocOps. Across 18 chapters of fresh concepts as well as concrete examples and exercises, Codewriting explores a new approach to developing and maintaining docs—​one that draws extensively from practices and environments proven by software engineering teams. Early drafts are available now in the same open-source repository from which the site you’re now reading was built (details below).

My free and open-source tool LiquiDoc enables true single sourcing of docs and product, building and optimizing semi-structured data into content for rendering in documentation and other user interfaces. In combination with several technologies like Git, Asciidoctor, Jekyll, and Liquid, LiquiDoc builds the site you’re reading now, as well as my book—​all from the same source repo.

Codewriting, LLC specializes in:

  • Documentation platform development, especially using

    • Ruby/Bash scripting

    • AsciiDoc/Asciidoctor

    • Jekyll/Liquid

  • Workflows for documentation development and management

  • Documentation planning and design

Codewriting, LLC works in collaboration with other code-oriented documentarians and docs-oriented developers to provide:

  • Product documentation

    • Developer guides and API docs

    • User manuals, help sites, and knowledge bases

    • Rich diagrams and illustrations

  • Docs transformation, including

    • Platform/source migration

    • Content localization and internationalization

  • Other technical communications services

    • Presentation design

    • Technical white papers

    • Specifications and proposals

Codewriting, LLC is sufficiently skilled and networked for full-service documentation projects, from tooling to information architecture to writing to deployment.

Exemplary Projects

My first year as an independent contractor was pretty productive. Besides maintaining LiquiDoc, LiquiDoc CMF, and other “side projects”, I worked for several clients that put my skills to the test. Here are some of my featured projects from 2018.

Other Resources