Skip to content

Conversation

@stepnem
Copy link
Contributor

@stepnem stepnem commented Sep 2, 2025

Two changes which might warrant explanation:

  1. 'misguided thoughts' is the title of Sean Gillespie's
    blog, but its lowercase spelling gives opportunity for the
    sentence to be misunderstood as editorial
    commentary (unlikely, granted, but gives the reader
    unnecessary pause); another option I considered was adding
    quotes or linkification, but saying just "on his blog" seems
    perfectly sufficient and clear.

  2. Add quotes around a part of the git-tools description to
    indicate that "help you make crazy stuff in a very unsafe
    way" is a direct quote of the tool author's description.
    Otherwise I feel that this, too, will give the reader pause,
    as it provides almost no information, in contrast with what
    we usually try to achieve with descriptions.

Two changes which might warrant explanation:

1. 'misguided thoughts' is the title of Sean Gillespie's
blog, but its lowercase spelling gives opportunity for the
sentence to be misunderstood as editorial
commentary (unlikely, granted, but gives the reader
unnecessary pause); another option I considered was adding
quotes or linkification, but saying just "on his blog" seems
perfectly sufficient and clear.

2. Add quotes around a part of the git-tools description to
indicate that "help you make crazy stuff in a very unsafe
way" is a direct quote of the tool author's description.
Otherwise I feel that this, too, will give the reader pause,
as it provides almost no information, in contrast with what
we usually try to achieve with descriptions.
@chriscool chriscool merged commit aad1c90 into git:master Sep 2, 2025
@chriscool
Copy link
Collaborator

Looks great to me, thanks @stepnem!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants