Skip to content

philips-software/docs-as-code

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Docs-as-Code

Example project to demonstrate the use of Asciidoc to generate software documentation. Combining models from the following sources:

Generation of diagrams is supported using PlantUML.

Please feel free to adjust the template and have fun generating you own documentation.

Getting Started

Prerequisites

  • Java installed
  • Graphviz installed (needed to generate diagrams)

Running

Execute the documentation generation by: ./gradlew asciidoctor

The generated documentation can be found at:

  • /build/asciidoc/index.html (HTML website)
  • /build/asciidoc/index.pdf (PDF document)

License

This project is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License - see the LICENSE file for details

Acknowledgments

  • The documentation template is inspired by the ARC42 model/C4-Model and Architecture Decision Records.

About

Example project to demonstrate the use of Asciidoc to generate software documentation. Using Arc42,C4,ADR and integration with PlantUML.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published