From: Kenneth Lorber <keni@xxxxxxx> This started as an effort to understand this section of config.txt: When inventing new variables for use in your own tool, make sure their names do not conflict with those that are used by Git itself and other popular tools, and describe them in your documentation. and grew from there. I don't expect this to be adopted as is, but I've found it much easier to discuss something concrete rather than an abstract "this is incomplete" or "this is hard to find." Cut from master. keni (6): Tell the glossary about core.hooksPath Add bit on extending git to Hacking Git Add namespace collision avoidance guidelines file Include NAMESPACE COLLISIONS doc into gitrepository-layout.txt Tell config.txt about NAMESPACE COLLISIONS Add NAMESPACE COLLISIONS reference to Hacking Git Documentation/config.txt | 4 +- Documentation/gitrepository-layout.txt | 2 + Documentation/glossary-content.txt | 10 ++- .../technical/namespace-collisions.txt | 86 +++++++++++++++++++ Documentation/user-manual.txt | 9 ++ 5 files changed, 106 insertions(+), 5 deletions(-) create mode 100644 Documentation/technical/namespace-collisions.txt -- 2.17.1