git/list[1] front-page[2] threads[3] people[4] search[5] about
 

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
Previous: Ævar Arnfjörð BjarmasonNext: Christian Couder
Message 16 of 18 in “Re: [RFE] Demilitarize Documentation (was RE: Delivery Status Notification (Failure))”
  1. Randall S. BeckerFeb 18, 2019
  2. Michal SuchánekFeb 18, 2019
  3. Junio C HamanoFeb 18, 2019
  4. Senol YaziciFeb 19, 2019
  5. Michal SuchánekFeb 19, 2019
  6. Johannes SchindelinFeb 19, 2019
  7. Michal SuchánekFeb 19, 2019
  8. SZEDER GáborFeb 19, 2019
  9. Senol YaziciFeb 19, 2019
  10. Johannes SchindelinFeb 19, 2019
  11. Michal SuchánekFeb 19, 2019
  12. Johannes SchindelinFeb 20, 2019
  13. Philip OakleyFeb 19, 2019
  14. SZEDER GáborFeb 20, 2019
  15. Ævar Arnfjörð BjarmasonFeb 19, 2019
  16. Michal SuchánekFeb 19, 2019
  17. Christian CouderFeb 19, 2019
  18. Michal SuchánekFeb 19, 2019

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.