Re: [PATCH v2 1/6] intro.1: Revise language

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 1274 bytes --]

Hi Jeremy, Branden,

On Mon, Mar 18, 2024 at 02:56:57PM -0500, G. Branden Robinson wrote:
> At 2024-03-19T08:50:21+1300, Jeremy Baxter wrote:
> > > cat will show
> > > but
> > > cp copies
> > > ?
> > 
> > I think it sounds better to use the "x does this" form rather than the
> > "x will do this" form, similar to what they have in the utilities' own
> > man pages. What do you think? Should I change cat's description to
> > adhere to the rest or just keep all of them as they were?
> 
> Two rules I've been applying to my man page revisions for a while are:
> 
> * Favor active voice over passive.
> * Favor present tense over future.
> 
> This is "favor", not "always use", but, other things being equal...

For intro(1), we could make an exception.  A less formal voice might
seem more friendly to newcomers.  Don't you think?

BTW Jeremy, you could send less changes.  I'm not very happy about such
huge changes suddenly.  How about fixing what you feel is most obvious
that should be fixed, say 20 lines or so, and in a month or so we can
discuss another patch set for this page?

Have a lovely day!
Alex

> 
> Regards,
> Branden



-- 
<https://www.alejandro-colomar.es/>
Looking for a remote C programming job at the moment.

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]