Re: [RFE] Demilitarize Documentation (was RE: Delivery Status Notification (Failure))
- From
Michal Suchánek <msuchanek@suse.de>
- Date
- Feb 19, 2019, 13:33 UTC
- Message-ID
- <20190219143328.20fce291@kitsune.suse.cz>
- In-Reply-To
- <87o97858ko.fsf@evledraar.gmail.com>
On Tue, 19 Feb 2019 12:19:51 +0100 Ævar Arnfjörð Bjarmason <avarab@gmail.com> wrote:
> On Tue, Feb 19 2019, Senol Yazici wrote: >
Show 24 quoted lines
> 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