> > But as this is plumbing and users should not need to worry about it
> > this is optional, I would think.
>
> The design document is also in 'Documentation/technical' instead of just
> 'Documentation/'. Do we have a pattern of linking to the technical
> documents?
Apparently we do (and I was not aware of it):
$ git -C Documentation/ grep link:technical
git-credential.txt:23:link:technical/api-credentials.html[the Git
credential API] for more
git.txt:839:link:technical/api-index.html[Git API documentation].
gitcredentials.txt:184:link:technical/api-credentials.html[credentials
API] for details.
technical/http-protocol.txt:517:link:technical/pack-protocol.html
technical/http-protocol.txt:518:link:technical/protocol-capabilities.html
user-manual.txt:3220:found in link:technical/pack-format.html[pack format].
