News, ideas & insights
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
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
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
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.
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.
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.
