OpenDevise
Home Services Support Blog About

Docs Dispatch

News, ideas & insights

AntoraArchitecting AntoraDocsNews
feature image for article
Sep 19, 2019

OpenDevise is striking for the Climate on Sept. 20th

The world is facing a climate and ecological crisis, an existential threat to life as we know it. To encourage action, OpenDevise and opendevise.com will be joining the Global Climate Strike on Sept 20th.

News

feature image for article
Dec 30, 2018

Antora 2.0 has Shipped!

We’re so excited to announce the release of Antora 2.0. This release streamlines the installation process, improves platform and library compatibility, provides a simpler and pluggable authentication mechanism for private repositories, and delivers the latest Asciidoctor capabilities.

Antora News

feature image for article
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

feature image for article
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

feature image for article
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

feature image for article
Nov 16, 2017

Documentation Ideas Coming Your Way!

Welcome to the OpenDevise blog. We’ll use this space to share our documentation ideas, insights, and experiences as well as news about our company and products.

News

OpenDevise

We help organizations achieve faster growth though better documentation.

© 2021 OpenDevise Inc.
Powered by Open Source.

Terms of Use - Privacy - Legal

Contact Info

Lone Tree, Colorado, USA

hello@opendevise.com

@opendevise

OSS by OpenDevise

Antora

A documentation site generator that enables technical writers to create, manage, remix, and publish documentation sites composed in AsciiDoc and sourced from a variety of versioned content repositories.

Asciidoctor

A fast text processor and publishing toolchain for converting AsciiDoc content to HTML5, DocBook, PDF, and other formats.