I just started using architecture decision records.
I’m liking it so far, even for solo projects.
I’m just using an in-repo docs/adr folder and using hand copy/paste/modify markdown files with one template file. Nothing fancy.
A couple resources for ADRs
- https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions
- https://www.redhat.com/architecture-decision-records
Brian Okken :python: /
npub1j7…vhmke
2024-09-19 22:11:35
Author Public Key
npub1j7suaykfmlyw23aty290ty6yquse2qewqy9gd9hunw4w2hkf343s8vhmkePublished at
2024-09-19 22:11:35Event JSON
{
"id": "b532212695d1896133159be2f4a8a64e5ffda9fa6741d6ac5ce586ce4626d46a",
"pubkey": "97a1ce92c9dfc8e547ab228af59344072195032e010a8696fc9baae55ec98d63",
"created_at": 1726783895,
"kind": 1,
"tags": [
[
"proxy",
"https://fosstodon.org/@brianokken/113166509345156895",
"web"
],
[
"proxy",
"https://fosstodon.org/users/brianokken/statuses/113166509345156895",
"activitypub"
],
[
"L",
"pink.momostr"
],
[
"l",
"pink.momostr.activitypub:https://fosstodon.org/users/brianokken/statuses/113166509345156895",
"pink.momostr"
],
[
"-"
]
],
"content": "I just started using architecture decision records.\nI’m liking it so far, even for solo projects. \nI’m just using an in-repo docs/adr folder and using hand copy/paste/modify markdown files with one template file. Nothing fancy. \n\nA couple resources for ADRs\n- https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions\n- https://www.redhat.com/architecture-decision-records",
"sig": "a2b84138f92ff5c6a5e325af55baec19e7848880d0bfe851667d93ddde89d71c33439f02f1ec3f762d4407eb2d6dd4fbdc01dd6bac34496d01dcbd27db751f84"
}