Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/docToolchain/docToolchain
a AsciiDoc Toolchain for technical Software Documentation, focused on Software Architecture Documentation
https://github.com/docToolchain/docToolchain
arc42 asciidoc asciidoctor asciidoctor-diagram asciidoctor-pdf confluence docs-as-code enterprise-architect hacktoberfest hacktoberfest2021
Last synced: 3 months ago
JSON representation
a AsciiDoc Toolchain for technical Software Documentation, focused on Software Architecture Documentation
- Host: GitHub
- URL: https://github.com/docToolchain/docToolchain
- Owner: docToolchain
- License: mit
- Created: 2016-07-05T20:18:50.000Z (over 8 years ago)
- Default Branch: ng
- Last Pushed: 2024-04-15T06:23:41.000Z (10 months ago)
- Last Synced: 2024-05-01T22:28:55.074Z (9 months ago)
- Topics: arc42, asciidoc, asciidoctor, asciidoctor-diagram, asciidoctor-pdf, confluence, docs-as-code, enterprise-architect, hacktoberfest, hacktoberfest2021
- Language: Groovy
- Homepage: https://doctoolchain.github.io/docToolchain/
- Size: 32.7 MB
- Stars: 707
- Watchers: 30
- Forks: 227
- Open Issues: 236
-
Metadata Files:
- Readme: README.adoc
- Changelog: changelog.adoc
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.adoc
Awesome Lists containing this project
- awesome-ccamel - docToolchain/docToolchain - a AsciiDoc Toolchain for technical Software Documentation, focused on Software Architecture Documentation (Groovy)
- jimsghstars - docToolchain/docToolchain - a AsciiDoc Toolchain for technical Software Documentation, focused on Software Architecture Documentation (Groovy)
README
:imagesdir: images
== docToolchain
:url-ci-travis: https://app.travis-ci.com/github/docToolchain/docToolchain
image:https://api.travis-ci.com/doctoolchain/doctoolchain.svg?branch=ng[link={url-ci-travis}]
[NOTE]
====
Corona/Covid19 is taking its toll.
Time is short in these times and issues are not worked on.
That is why I (rdmueller) have just introduced `sponsored` issues with higher priority.
The label should help to explain why some issues will be preferred over others.
If you want to sponsor an issue, just use the sponsor link on top of this page.
====[IMPORTANT]
====
If you have used docToolchain in the past, please be aware that the master branch is undergoing some changes.If you are looking for a fresh version and are willing to accept changes in the configuration, this `ng` branch is the right thing for you.
If you are looking for what you are used to, then download https://github.com/docToolchain/docToolchain/releases[the V1.0.0 release]
====image:https://travis-ci.org/docToolchain/docToolchain.svg?branch=master["Build Status", link="https://travis-ci.org/docToolchain/docToolchain"]
image:https://opencollective.com/doctoolchain/backers/badge.svg["Backers on Open Collective"]
image:https://opencollective.com/doctoolchain/sponsors/badge.svg["Sponsors on Open Collective"]=== create awesome docs!
_docToolchain_ is an implementation of the http://www.writethedocs.org/guide/docs-as-code/[_docs-as-code_] approach for software architecture.
The basis of docToolchain is the philosophy that software documentation should be treated in the same way as code together with the http://arc42.org[_arc42_] template for software architecture.https://docToolchain.github.io/docToolchain[read more...]
image::https://doctoolchain.github.io/docToolchain/v2.0.x/images/ea/Manual/Overview2.png[]
//TODO: this is the v1.3.x report:
https://doctoolchain.github.io/docToolchain/v1.3.x/htmlchecks/[htmlSanityCheck Test Results]=== Contributors
This project exists thanks to all the people who contribute!
image::https://opencollective.com/doctoolchain/contributors.svg?width=600&button=false[]
See also the https://doctoolchain.github.io/docToolchain/v2.0.x/010_manual/040_contributors.html[list of contributors] from the docs.
Each contribution is highly valuable and appreciated, no matter how big it is - there are no small contributions.
Even just fixing a typo or starring the project helps to promote it.I decided to give people and companies a chance to support this project.
This is done through https://opencollective.com - the same service which https://asciidoctor.org/[Asciidoctor] uses.=== Companies who use docToolchain
docToolchain is still one of the smaller open source projects,
but some companies already fully embrace the docs-as-code approach through docToolchain.
If your company uses docToolchain, then feel free to add your company's logo through a pull request.
Please state in the PR that we are allowed to display the logo within all projects websites and documentation.[cols="1,2"]
|===
a| [link=https://www.tomtom.com]
image::TomTomLogo.png[TomTom, width=50%]a| [link=https://www.dbsystel.de]
image::db-logo.svg[DB Systel, width=50%]a| [link=https://www.codecentric.de]
image::cclogo.png[codecentric, width=50%]a| [link=https://www.innoq.com]
image::innoq-logo.svg[INNOQ, width=50%]
|====== Backers
Thank you to all our backers!
image::https://opencollective.com/doctoolchain/backers.svg?width=890["Become a Backer", link="https://opencollective.com/doctoolchain#backers"]
=== Sponsors
Support us by becoming a sponsor. Your logo will show up here with a link to your website.
https://opencollective.com/doctoolchain#sponsors[Become a Sponsor]
image::https://opencollective.com/doctoolchain/sponsor/0/avatar.svg["Sponsor", link="https://opencollective.com/doctoolchain/sponsor/0/website"]
=== History of this project
I just found an older https://twitter.com/RalfDMueller/status/668540860649349120[tweet] which reminded me of the roots and beginning of this project.
It all began with two important parts.
A script called asciidoc2confluence and some scripts to export diagrams from enterprise architect.The first one is linked in the tweet above and the first commit dates back to mid of 2015.
Since then, many contributors have joined!
Thank for all of your contributions!