Welcome to the arc42 Confluence Template space. Here you find all you need to get started with your software architecture documentation if you want to use Confluence as your content management system.
But you still have several ways to use arc42 with Confluence:
There are two flavours for each language which we call 'flat' and 'structured'. The difference between them is just into how many Confluence pages the template has been split. The 'flat' version consists of one page per level 1 chapter (12 pages overall). The 'structured' versions consists of one page per level 2 chapter.
We've already prepared space exports for you:
How you can import them into your own confluence is described in the Confluence documentation: Import a Confluence Space
Pros:
Cons:
You want to make your document public available? There is still lots of free space in this confluence - just contact us! |
There are two Confluence plugins available on the Atlassian marketplace which help you to create arc42-style docs in Confluence:
Just give them a try
Pros:
Cons:
docToolchain is an open source Gradle build which takes an Asciidoc document as input and renders it in various formats. I already works quite well but still lacks some documentation:
./gradlew
build
-folder./scripts/ConfluenceConfig.groovy
and edit this config according to your needs and setup../gradlew publishToConfluence
If you want to stay updated about the progress of docToolchain, just follow the twitter account @docToolchain. If you need help, please use the github issue-tracker.
Pros:
Cons:
With docToolchain lets you not only immport the template to Confluence, but it also allows you to use AsciiDoc as your master document. Just follow the steps above and start to write your documentation within the ./src/docs
folder of the Gradle build. Everytime you want to publish your document to Confluence, run the standard Gradle build followed by ./gradlew publishToConfluence
- only changes will be published.
Pros:
Cons:
PS: a big "Thank you!" to Atlassian for providing this cloud instance of Confluence! |