OpenDevise

Services

Antora Documentation Pipelines

We develop automated tools and build processes that take the complexity, human effort, and anxiety out of deploying documentation sites.

DevOps for Documentation Teams

We help teams upgrade to a modern, agile workflow for creating, reviewing, testing, and publishing documentation composed in the lightweight markup language AsciiDoc.

Asciidoctor & AsciiDoc

We’re experts at writing & processing AsciiDoc

As the maintainers of Asciidoctor, we have a deep understanding of how to best integrate and adapt the leading AsciiDoc platform into your documentation team’s workflow. Here are just a few ways we help teams save time, minimize risk, and increase their writing and publishing productivity.

Toolchain setup & configuration
Content migration
Content architecture & validation
Publishing pipeline design
Extension & UI development
Hands-on training

Signals from the Docs Dispatch

Dec 8, 2017

Referencing Pages

Technical documentation requires readers to take in a lot of complex information. To make documentation consumable, readers need a logical flow of pages to navigate. To help readers get from one page to the next, we need a simple and reliable system for creating references between pages. This article proposes an intuitive and stable page referencing system for documentation.

Antora Architecting Antora Docs

Nov 20, 2017

A Standard Project Structure for Documentation

If you browse the source code of software projects, you’ll notice that projects built for the same platform share a common structure. This practice makes projects immediately recognizable. It also matches the assumptions of tools that build them. No such structure exists for documentation. To reduce friction when writing, and to make way for a stronger ecosystem of tools, this article proposes a standard directory structure for documentation projects.

Antora Architecting Antora Docs

Nov 16, 2017

Content is Sovereign

Content is king. That we know. But we forget that content is also sovereign. Too often, that independence gets trampled when producing a documentation site, giving rise to a content monolith. In this article, we present a new way of organizing content for a documentation site that respects and utilizes the content’s sovereignty.

Antora Architecting Antora Docs

Our Clients

Ship your documentation as fast as your product.

Services

Antora Documentation Pipelines

DevOps for Documentation Teams

Asciidoctor & AsciiDoc

We’re experts at writing & processing AsciiDoc

Signals from the Docs Dispatch

Referencing Pages

A Standard Project Structure for Documentation

Content is Sovereign

Ready? Let's do this!