The text itself is at https://github.com/git/git/blob/master/Documentation/rev-list-options.txt#L386-L425, should you wish to try making it clearer.
Unfortunately, there isn't a sample repo that contains the various examples that are in the documentation. There are one or two that are hidden in the test suite, but this doesn't appear to be one of them. How would you update the documentation to make it more useful to folks like yourself trying to understand what is going on? Try posting here and folks can help with preparing some patches to improve things. Philip On Friday, January 14, 2022 at 9:34:12 AM UTC Konstantin Khomoutov wrote: > On Thu, Jan 13, 2022 at 05:57:24PM -0800, Chuck Lu wrote: > > >>> https://git-scm.com/docs/git-log#_history_simplification > >>> As there is no change, then how can I make a commit C? > >>> [image: firefox_2022-01-13_19-46-27.png] > >> Commit C is to be compared to I. > >> > >> In `I` foo contains "asdf" > >> In `C` foo contains "foo" as described under 'A' (same as B, same as > C...) > >> so a confusion about the english way of describing and the graphical > >> expectation. > >> At least that's what I'm thinking. > [...] > > Yes, I know that C compare with I, and the description C does not change > > foo, the foo is in red color, which means the C does not change file > foo. > > The content in file foo should keep the same as I which is "asdf". It's > > really awful to read the documentation. > > Anyway, thanks for your help, I will try to reproduce a repository with > > your explanation. > > > > Does anyone know who wrote this terrible documentation? If it is > possible, > > I would like to communicate with him/her directly. > > The docs are written by the developers theirselves (the project is run by a > volunteers, and AFAIU they don't have a dedicated technical writer in the > team, and never had). You can contact the devs by posting a mail to the > developers' list - please be sure to read [1]. > > Just in case, I urge you to be constructive: since Git is a volunteer > project, > and a piece of F/OSS, you got it for free, have full access to its source > code - which includes the sources of the docs - and, as usual in such > cases, > the Git devs are not under any obligation to maintain whatever level of > quality > of their product. Hence you cannot sensibly demand anything from them - at > best, your claims will be silently dismissed; what you could - and should - > do instead is to propose ways to improve the docs: usually this is made in > four steps: you offer the changes, discuss them, then post the patches, > then > they are reviewed, which might require multiple backs-and-forths to get > completed. > > 1. > https://gist.github.com/tfnico/4441562#writing-an-email-to-the-developers-list > > -- You received this message because you are subscribed to the Google Groups "Git for human beings" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/git-users/ca3539a5-d4f3-4b8a-9a49-e27a1bece701n%40googlegroups.com.
