Philip Oakley <philipoakley@iee.email> writes: > This may be not part of the the main project, but could you consider, if > time permits, also adding some entries into the Git Glossary (`git help > glossary`) for the various terms we are using here and elsewhere, e.g. > 'topological levels', 'generation number', 'corrected commit date' (and > its fancy technical name for the use of date heuristics e.g. the > 'chronological ordering';). > > The glossary can provide a reference, once the issues are resolved. The > History Simplification and Commit Ordering section of git-log maybe a > useful guide to some of the terms that would link to the glossary. Ah, I first thought that Documentation/rev-list-options.txt (which is the relevant part of "git log" documentation you mention here) already have references to deep technical terms explained in the glossary and you are suggesting Abhishek to mimic the arrangement by adding new and agreed-upon terms to the glossary and referring to them from the commit-graph documentation updated by this series. But sadly that is not the case. What you are saying is that you noticed that rev-list-options.txt needs a similar "the terms we use to explain these two sections should be defined and explained in the glossary (if they are not) and new references to glossary should be added there" update. In any case, that is a very good suggestion. I agree that updating "git log" doc may be outside the scope of Abhishek's theme, but it would be very good to have such an update by anybody ;-) Thanks
