[Top][All Lists]

[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

reply via email to

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