Re: [PATCH v2] docs: add a FAQ

From: Martin Ågren <martin.agren@gmail.com>
Date: Mar 25, 2020, 18:03 UTC
Message-ID: <CAN0heSomisiFsO-_bkGYFgj0nS5yZy9ewU883APDiMK5Sw=srg@mail.gmail.com>
In-Reply-To: <20200325110328.GK6499@camp.crustytoothpaste.net>

On Wed, 25 Mar 2020 at 12:03, brian m. carlson <sandals@crustytoothpaste.net> wrote:

Show 24 quoted lines

>
> On 2020-03-25 at 06:23:49, Martin Ågren wrote:
> > On Wed, 25 Mar 2020 at 02:37, brian m. carlson
> > I read this as:
> >
> >   How do I prevent users from making "certain changes with hooks"?
> >
> > As opposed to your intended meaning:
> >
> >   How do I (with hooks) prevent users from making certain changes?
> >
> > I'm not suggesting the latter as a "fix" for this "problem" though,
> > since it's a bit clumsy. How about adding a comma:
> >
> >   How do I prevent users from making certain changes, with hooks?
> >
> > Or maybe just dropping those last two words.
> >
> > Please trust your judgement on whether this is a problem, and if so, how
> > to go about addressing it -- I know you have lots of such judgement.
>
> How about, "How do I use hooks to prevent users from making certain
> changes?"  That seems to both read smoothly and avoid the misplaced
> modifier.

Very nice.

Martin