docs: add best practices for server and client implementors - #36

Open

tadasant wants to merge 13 commits into

mainfrom

docs/best-practices

Commits on Jul 20, 2026

docs: add best practices for server and client implementors
tadasant
committed
472f446
docs: restructure server implementor guidance into prose subsections
tadasant
committed
52126c3
docs: lead client guidance with the value case, group by concern
tadasant
committed
0592542
Refinements
tadasant
authored
e6ee9b6
docs: tighten client install consent, drop out-of-session install path
tadasant
committed
d57f37a
docs: demote Goose from framing device to illustration
tadasant
committed
de65e76
docs: correct factual errors, add SSRF bounds, drop endorsement framing
tadasant
committed
2ce630b
docs: recommend .well-known, point at Link header and <link> alternatives
tadasant
committed
1649820
docs: explain only .well-known, track other discovery modes in #43
tadasant
committed
b8b59eb
docs: drop nested-catalog guidance, track in #44
tadasant
committed
78a4e5e

Commits on Jul 24, 2026

Update docs/best-practices.md

tadasant
and
SamMorrowDrums
authored
b5d16da
docs: wrap prose consistently in best-practices.md
tadasant
committed
e370342
docs: 'recommending anything' over 'anyone'
tadasant
committed
1b06488