On Tue, 19 Feb 2019 12:19:51 +0100 Ævar Arnfjörð Bjarmason <avarab@xxxxxxxxx> wrote: > On Tue, Feb 19 2019, Senol Yazici wrote: > > 2) Any piece of software or technical tool is going to unavoidably need > to use some amount of jargon, or words that are lifted from a more > general vocabulary and intended to be understood in context. > > Thus, when we talk about e.g. "trees" in git, it's understood that > we're talking about something in the context of this software > project, trying to go by the first Google result of "tree" isn't > going to get you anywhere. > > I for one thing those git-scm docs could be changed to eliminate those > words for reasons entirely unrelated to them somehow being religious or > militaristic. Specifically: > > * "blessed" is introduced in quotes and used twice. I think it would be > clearer to use "canonical" for what it's describing. > > * The docs already use "integration manager" and then introduce > "dictator" as a synonym in the context of explaining the workflow of > the kernel. > > They could instead use "main integrator" or something, since the > point of the example is to explain how git can be used to manage > distributed repositories that are integrated in a hierarchical > manner. And that is a good reason to change the wording for once. Thanks Michal
