ZVY-0180 Antora: Documentation Sites for Software Teams | Devoxx

Devoxx Belgium 2018
from Monday 12 November to Friday 16 November 2018.

   Antora: Documentation Sites for Software Teams


Modern Web & UX
Beginner & novice level
Room 3 Wednesday from 13:05 til 13:20

Your documentation gives users a first impression of your software; its “curb appeal”. How do you create it? How do you manage it? How do you publish it? What about versions?

Despite there being countless site generators to choose from, few are well-suited for large-scale documentation sites, and none designed exclusively for AsciiDoc. Writers need the ability to create and manage documentation sites without needing deep knowledge of the web stack. Software teams need a workflow to collaborate on multiple versions of documentation that span departments. By creating Antora, we set out to fill these gaps. I’ll explain how we architected Antora and how it changes the way we think about producing documentation.

Antora aggregates versioned content from a variety of repositories and branches that adhere to a standard project structure. It then converts that content and feeds it to a UI, which is provided by a separate software component. Out comes an offline-first site that can be published and viewed anywhere, even locally.

This talk will give you an understanding of how Antora enables software teams to effectively create, manage, and publish multi-version documentation sites.

documentation   websites   workflow   collaboration  
Subscribe to Devoxx on YouTube
Dan Allen
Dan Allen
From OpenDevise

Dan is a software developer, thinker, creative, published author (Seam in Action), and internationally-recognized speaker. Dan builds movements behind software by bringing together communities of creatives to pursue ideas and solve big problems. His goal is to foster software projects that default to open and thrive on transparency.

Dan leads the Asciidoctor project, co-leads the Antora project, and promotes the JVM as a polyglot Java Champion. As one of two founders of OpenDevise, Dan works with software projects to help organizations produce documentation their users adore.

After a long conference day, you’ll find Dan chatting about tech, docs, and open source with fellow community members over a Trappist beer or Kentucky bourbon.

Make sure to download the Android or iOS mobile schedule.