Login
You're viewing the burningboard.net public feed.

Replies

  • VerdettoVerdettoQR@mastodon.social
    Oct 13, 2026, 1:28 PM

    @oliverzehentleitner I keep the why in the repo that owns the change, as a dated line beside it. Across repos there's only an index of pointers, so one repo's decision stays invisible until someone follows it. Does your comparison weigh that trade?

    💬 1🔄 0⭐ 1
  • Oliver Zehentleitneroliverzehentleitner
    Oct 13, 2026, 2:30 PM

    Yes, that's very close to the tradeoff I ended up with.

    One repo owns the canonical rationale. Other repos only reference it by repo + stable ID, rather than copying or importing the decision.

    The downside is exactly what you describe: without another discovery mechanism, those relationships can stay invisible until someone follows a pointer.

    KTW keeps ownership decentralized, but adds two derived discovery layers:

    Registry:
    keepthewhy.com/registry/

    Cross-repo graph:
    keepthewhy.com/dashboard/live/

    The registry helps discover participating repositories, while the graph makes the actual relationships between decisions visible.

    So the tradeoff is basically: strong provenance and no duplicated truth, in exchange for needing derived discovery on top.

    💬 0🔄 0⭐ 0