from Hacker News

Ask HN: Open-Source Project with ADR?

by lapaz17 on 3/4/21, 6:17 PM with 2 comments

Hi, I want to learn how an open source project with good code quality evolved over time by tracking down ADR(Architectural Decision Records)(or something similar). Is there any? I think my googling skills were short this time. Thanks in advance.

  • by gumatias88 on 3/17/21, 2:35 AM

    Another non-exact answer, though I thought I'd add some color of a different shade: ADR is a relatively recent concept that's been making its way into organizations and becoming more mainstream that its "grandfather" - or in nicer terms, counterpart - RFC (Request For Comments).

    RFCs is another type of technical decision making documentation that has been popular for decades now, and can probably be found more widely as it's more spreadout online from what I can tell. It's worth pointing out that RFCs are less easier to locate it next to specific implementations, since it focuses heavily on a more abstract type of standardization and specification document, and lives further away from the code than ADRs for example.

    All of that to say if the intent is to track down code historial evolution, some types of RFCs out there _might_ help shed some facet of the light you may be looking for.

  • by msantos on 3/4/21, 8:07 PM

    I don't have an exact answer to your question, but I'd suggest you try Gitlab's advanced search, instead of Google.

    And GitHub too for that matter - e.g. "stars:>100 forks:>20 path:/adr license:apache-2.0" this will search for GitHub repos which have over 100 stars, over 20 forks, Apache 2.0 OSS licence, and a directory named "adr"