Thread (14 messages) 14 messages, 3 authors, 2022-01-06

Re: [PATCH v2 0/3] Additional FAQ entries

From: Johannes Schindelin <hidden>
Date: 2022-01-04 13:53:54

Hi Eric,

On Sun, 7 Nov 2021, Eric Sunshine wrote:
On Sun, Nov 7, 2021 at 5:55 PM brian m. carlson
[off-list ref] wrote:
quoted
This series introduces some additional Git FAQ entries on various
topics.  They are all things I've seen in my professional life or on
Stack Overflow, so I've written documentation.

Changes from v1:
* Drop the monorepo patch for now; I want to revise it further.
* Reorder the working tree patch to place more warnings up front.
* Mention core.gitproxy and socat.
* Rephrase text in the EOL entry to read correctly and be easier to
  understand.
* Improve the commit message for the working tree FAQ entry to make it
  clearer that users wish to transfer uncommitted changes.
Thanks for re-rolling. FAQ entries are, of course, bikeshedding
fodder,
That is one possible perspective. Another possible perspective is that FAQ
entries are the first thing users in distress might turn to, so the more
helpful they are, the better. Maybe it would make sense to focus on that
a bit more. As in your suggestion to name cloud sync providers by name, to
make the FAQ entry eminently more "findable". To me, that did not at all
feel like pointless bike-shedding, but more like a really valuable
improvement that users will appreciate (even if they will be oblivious of
the fact that they appreciate it, of course).

Ciao,
Dscho
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help