[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.
- Stylistic changes to tree-sitter code, Po Lu, 2022/10/27
- Re: Stylistic changes to tree-sitter code, Robert Pluim, 2022/10/27
- Re: Stylistic changes to tree-sitter code, Po Lu, 2022/10/27
- Re: Stylistic changes to tree-sitter code, Yuan Fu, 2022/10/28
- Re: Stylistic changes to tree-sitter code, Robert Pluim, 2022/10/28
- Re: Stylistic changes to tree-sitter code, Po Lu, 2022/10/28
- Re: Stylistic changes to tree-sitter code, Po Lu, 2022/10/28
- Re: Stylistic changes to tree-sitter code, Yuan Fu, 2022/10/29
- Re: Stylistic changes to tree-sitter code, Po Lu, 2022/10/29
- Re: Stylistic changes to tree-sitter code,
Eli Zaretskii <=
- Re: Stylistic changes to tree-sitter code, Po Lu, 2022/10/29
- Re: Stylistic changes to tree-sitter code, Eli Zaretskii, 2022/10/29
- Re: Stylistic changes to tree-sitter code, Po Lu, 2022/10/29
- Re: Stylistic changes to tree-sitter code, Eli Zaretskii, 2022/10/29
- Re: Stylistic changes to tree-sitter code, Stefan Kangas, 2022/10/29