[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Your commit 7409a79
From: |
Stephen Leake |
Subject: |
Re: Your commit 7409a79 |
Date: |
Wed, 10 Dec 2014 11:05:34 -0600 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.3.94 (windows-nt) |
Richard Stallman <address@hidden> writes:
> [[[ To any NSA and FBI agents reading my email: please consider ]]]
> [[[ whether defending the US Constitution against all enemies, ]]]
> [[[ foreign or domestic, requires you to follow Snowden's example. ]]]
>
> > Write documentation strings in the active voice, not the passive,
> > and in the present tense, not the future. For instance, use
> > Return a list containing A and B. instead of A list containing A
> > and B will be returned.
>
> Thanks. I should probably move the advice from there into the GNU
> standards, since they are applicable to any manual.
This came up in a discussion of commit messages and Changelogs; would
you recommend active voice, present tense (not past), for those?
--
-- Stephe
- Re: Your commit 7409a79, (continued)
- Re: Your commit 7409a79, Stefan Monnier, 2014/12/06
- Re: Your commit 7409a79, Stephen Leake, 2014/12/07
- Re: Your commit 7409a79, Stefan Monnier, 2014/12/07
- Re: Your commit 7409a79, Stephen Leake, 2014/12/08
- Re: Your commit 7409a79, Thien-Thi Nguyen, 2014/12/08
- Re: Your commit 7409a79, Stefan Monnier, 2014/12/08
- Re: Your commit 7409a79, Stephen Leake, 2014/12/08
- Re: Your commit 7409a79, Richard Stallman, 2014/12/09
- Re: Your commit 7409a79, David Kastrup, 2014/12/09
- Re: Your commit 7409a79, Richard Stallman, 2014/12/10
- Re: Your commit 7409a79,
Stephen Leake <=
- Re: Your commit 7409a79, Stefan Monnier, 2014/12/10
- Re: Your commit 7409a79, Eli Zaretskii, 2014/12/08
- Re: Your commit 7409a79, Stephen Leake, 2014/12/08