madr icon indicating copy to clipboard operation
madr copied to clipboard

Published 20 hours ago • verified publisher icon adr

Support for large projects

Open koppor opened this issue 6 years ago • 3 comments

One large repository

  • Add categories to the ADRs (refs https://github.com/adr/madr/issues/7)
  • Offer a web-based viewer

Several repositories

In addition

  • there is an overarching repository collecting the ADRs of the sub repositories using git submodules
  • there is a web-based tool for browsing.

koppor avatar Mar 05 '18 13:03 koppor

In my opinion, a web-based tool for browsing already exists: markdown files will be automatically rendered in most online version control repositories. So this page is the web-based viewer for this project.

Furthermore, tools exist to automatically generate pages/sites from collections of markdown documents. For example, pandoc for straight-forward document conversions or site generators like Jekyll or HUGO.

tomlankhorst avatar Jul 08 '18 20:07 tomlankhorst

As mentioned here, I developed a tool with a web UI and tags support for ADRs.

Log4brains is a docs-as-code knowledge base for your development and infrastructure projects. It enables you to write and manage Architecture Decision Records (ADR) right from your IDE, and to publish them automatically as a static website.

https://github.com/thomvaill/log4brains

I am looking for beta testers and any feedback will be very welcome! 🙏

thomvaill avatar Dec 11 '20 14:12 thomvaill

Can't this be closed?

Hnasar avatar Sep 15 '22 01:09 Hnasar