[PATCHv3] submodules: overhaul documentation

2017-06-22 Thread Stefan Beller
This patch aims to detangle (a) the usage of `git-submodule` from (b) the concept of submodules and (c) how the actual implementation looks like, such as where they are configured and (d) what the best practices are. To do so, move the conceptual parts of the 'git-submodule' man page to a new man

Re: [PATCHv3] submodules: overhaul documentation

2017-06-21 Thread Junio C Hamano
Stefan Beller writes: > +DESCRIPTION > +--- > + > +A submodule is another Git repository tracked inside a repository. > +The tracked repository has its own history, which does not > +interfere with the history of the current repository. As a naive reader, I have/got no idea what it means

[PATCHv3] submodules: overhaul documentation

2017-06-21 Thread Stefan Beller
This patch aims to detangle (a) the usage of `git-submodule` from (b) the concept of submodules and (c) how the actual implementation looks like, such as where they are configured and (d) what the best practices are. To do so, move the conceptual parts of the 'git-submodule' man page to a new man