emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Stylistic changes to tree-sitter code


From: Eli Zaretskii
Subject: Re: Stylistic changes to tree-sitter code
Date: Sat, 29 Oct 2022 10:01:15 +0300

> From: Po Lu <luangruo@yahoo.com>
> Cc: Robert Pluim <rpluim@gmail.com>,  emacs-devel@gnu.org
> Date: Sat, 29 Oct 2022 13:44:55 +0800
> 
> Yuan Fu <casouri@gmail.com> writes:
> 
> > Also, out of curiosity, I thought active voice is good and passive
> > voice is bad? Though the subject here doesn’t add any useful
> > information, I recon.
> 
> But not in comments and documentation.

Yes, in comments and documentation as well.

>                                      IME, a very important point in
> writing documentation and comments is to avoid the use of pronouns
> unless absolutely necessary: "I", "you", "we", et cetera.  Especially
> "we", which is also so hard to avoid even I make the mistake of using it
> occasionally.

That is correct, but your change removed only "we", and left "I"
intact.  In any case, rephrasing to avoid pronouns doesn't necessarily
force us to use passive voice.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]