arc42 / arc42-template

arc42 - the template for software architecture documentation and communication
https://arc42.org
Other
1.02k stars 178 forks source link
arc42 architecture documentation hacktoberfest hacktoberfest2022

= image:./small-arc42-logo.png[arc42] Template ("Golden Master") :version 8.2: :downloads https://arc42.org/downloads/:

image:https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg[https://vshymanskyy.github.io/StandWithUkraine]

arc42 - the template for effective, practical and pragmatic software architecture documentation and communication.

Initially created by Dr. Gernot Starke and Dr. Peter Hruschka (way back in 2005...), free and open source.

This repository contains all downloadable versions plus the (AsciiDoc) source of the arc42 template.

It is used...

In case you find issues within the template or its explanations, this is the repo to fix and issue pull requests :-)

== Revisions

== Diagrams We intend to provide all diagrams in platform-neutral formats, mainly drawio.

The source of these diagrams is embedded in a .png file. To make this explicit, we use the combined extension .drawio.png for our diagrams. The drawio tools will recognize this and open such files in the editor instead of an image viewer.

Therefore we will gradually remove all files under ./graphics-originals

== Downloads

Please refer to the https://arc42.org/download[official download page] for all downloads.

== Languages

The EN and DE versions are actively maintained by the founders (G.Starke & P.Hruschka). Translations to additional languages (see below) have been provided by volunteers, but won't be automatically updated.

== Build the HTML version

In case you want to build the HTML version of the template, just checkout this repo and call


$> gradle asciidoctor

on the command line. To select another language set the Gradle build property LANGUAGE to one of the provided languages, cf.

[source, java]

include::gradle.properties[]

Currently (March 2022) you need to use Java 8 to build!

== Questions on using arc42?

== Suggestions welcome

Open an issue here!