adr / adr.github.io Goto Github PK

Add adr-tools-python to tooling section

https://fs.blog/decision-journal/

and https://fs.blog/knowledge-project-podcast/gary-klein/

might also be of interest for this community.

Hi,
i developed another ADR. tool implementation in golang, basically for my personal use and some colleagues, but maybe it is of interest for other ADR users as well:
https://github.com/dukemarty/adr-go/

• https://cards42.org/

Possibly also think about explaining the first ADR format ever, too.

Hi!
I made a video on ADRs, and another one on the applications of ADRs is coming up. Might be nice to link here: https://video.saxion.nl/media/Architecture+Design+Records+%28ADR%29+-+The+Basics/1_tbcapp6s

Disclaimer: I'm one of the founders of Loqbooq

While Loqbooq is maybe more in general a tool for maintaining decision logs, it's very much inspired by using ADRs in our projects before. We were just always missing the inclusion of project managers and designers. Loqbooq is a Web App with a Slack integration.

Maybe this could be an addition to the tooling part of your website (I'm happy to create a PR for it), if not, please close and ignore. Anyway, thanks for documenting ADRs, this definitely already helped me introducing ADRs to colleagues and with keeping projects successful before!

Cheers!

Just stumbled on the adr resources and they seem to have many similarities with Red Hat's Open Decision Framework.
It would be useful to also mention it on the Website to get a better picture of other initiatives, which influenced or are alternatives to adr.

As a person working on a project with software and hardware components, the usage of "software" on the adr.github.io page makes me think it only applies to software when it works just as well for hardware architectural decisions.

I want my hardware engineers not to think this is for software engineering only.

As a guest of adr.github.io I want to know where the GitHub repository is so I can file a bug or PR.

😉

No sign from the author for more than 18 months.

According to discussions in the issues there, the author seems unreachable, including by other means than GitHub (e.g. social networks)

I'd therefore suggest moving log4brains to the list of “Interesting, but unmaintained tooling”

Please provide license information for this project. Conditions of use, etc..

• https://www.lasssim.com/architecture-decision-records-example/ "At https://adr.github.io/ you can find an excellent overview of this technique."
• https://www.linkedin.com/pulse/what-architecture-decision-record-adr-do-i-need-how-useful-atmakur (?)

When viewing the website on a mobile phone, there is a black bar on the right and the headings are truncated.

A first analysis showed that the two last commits to the theme cause this. I'm unable to extract the intent of the two commits, so I don't know what they tried to achieve/prevent.

Once the two commits would be rolled back, the two very long links in the text and at the end that can't be wrapped are problematic for the mobile view. They could be rewritten with a text representing the link, or they could be wrapped with zero-width-spaces.

(Phone is a Google Pixel with Android 8.1 and Chrome 67)