madr
Markdown Architectural Decision Records (by adr)
docs
API Platform documentation (by api-platform)
madr | docs | |
---|---|---|
6 | 1 | |
1,352 | 163 | |
1.8% | 1.8% | |
6.8 | 8.7 | |
8 days ago | 7 days ago | |
GNU General Public License v3.0 or later | - |
The number of mentions indicates the total number of mentions that we've tracked plus the number of user suggested alternatives.
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
madr
Posts with mentions or reviews of madr.
We have used some of these posts to build our list of alternatives
and similar projects. The last one was on 2023-11-02.
-
Ask HN: How do you document engineering efforts?
MADR [1] in its reframed "Any Decision Record" form can be a good tool for that. RFDs [2] also appear to capture a similar intent.
[1]: https://adr.github.io/madr/
[2]: https://rfd.shared.oxide.computer/rfd/0001
-
Documenting your decisions using the ADR approach
Markdown Any Decision Records
-
A practical overview on Architecture Decision Records (ADR)
There is an interesting win-win tool called log4brains, that can turn your markdown into a static website. It's also integrated into MADR template. I haven’t had time to try them yet, but it's in my backlog.
- Stuck with crazy incompetent peer
-
The disproportionate influence of early tech decisions
It can be helpful to write down the context of why you made your decision, so that if/when you revisit it later it’s more clear. ADRs are one way to do this: https://adr.github.io/madr/
- How can I best deal with an engineer who disagrees with an architecture decision?
docs
Posts with mentions or reviews of docs.
We have used some of these posts to build our list of alternatives
and similar projects. The last one was on 2022-01-26.
-
Looking for opinions of API-Platform
This issue tracks what we want to do: https://github.com/api-platform/docs/issues/884
What are some alternatives?
When comparing madr and docs you can also consider the following projects:
architecture_decision_record - Architecture decision record (ADR) examples for software planning, IT leadership, and template documentation
schema-generator - PHP Model Scaffolding from Schema.org and other RDF vocabularies
log4brains - ✍️ Log and publish your architecture decisions (ADR)
documentation - API documentation
core - The server component of API Platform: hypermedia and GraphQL APIs in minutes
API Platform - Create REST and GraphQL APIs, scaffold Jamstack webapps, stream changes in real-time.