Thomas Ackermann <th.acker@xxxxxxxx> writes: > While proof-reading the user-manual I noticed some issues with glossary-content.txt: > > - There is some outdated, misleading or irrelevant information which might only confuse > new Git users and should therefore be removed. > - The entries for object, object name and SHA1 lacked a little bit of consistency. > - The glossary contains partial definitions for refspec and pathspec. Only on the "partial" bit, and not limited to refspec and pathspec. I think ideally for any key concepts: - The glossary should mention what it is and what it is used for; - Individual manual pages should mention how it is constructed and how it can be used. To be complete, it may need to start by describing what it is and what it is used for, which may have to duplicate what we say in the glossary. -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html