docs: add note about global, clean up template
Merge pull request #827 from jonboulle/master

docs: add note about global, clean up template