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/20220114093406.23e6xcbqdsxybtdr%40carbon.
