cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwbro...@apache.org
Subject [17/17] docs commit: [CB-3962] clarify passive-voice better for reference doc
Date Mon, 04 Nov 2013 19:53:25 GMT
[CB-3962] clarify passive-voice better for reference doc


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/77386813
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/77386813
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/77386813

Branch: refs/heads/master
Commit: 77386813f663c14d516eb105efaac60c2a3cec8f
Parents: 082b8a1
Author: Mike Sierra <msierra@adobe.com>
Authored: Mon Nov 4 13:35:16 2013 -0500
Committer: Michael Brooks <michael@michaelbrooks.ca>
Committed: Mon Nov 4 11:53:02 2013 -0800

----------------------------------------------------------------------
 STYLESHEET.md | 2 ++
 1 file changed, 2 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/77386813/STYLESHEET.md
----------------------------------------------------------------------
diff --git a/STYLESHEET.md b/STYLESHEET.md
index 78545b6..af18aa9 100644
--- a/STYLESHEET.md
+++ b/STYLESHEET.md
@@ -128,6 +128,8 @@ immensely.
 * __Avoid Passive Voice__: Past-tense passive voice is to be avoided.
   E.g., "the pause event fires when..."  rather than "the pause event
   is fired when..." Rule of thumb: banish verbs ending in "ed".
+  Passive voice is more appropriate for reference doc, you should
+  still avoid it when there's a better active-voice alternative.
 
 * __Not Kidding, Use Present Tense__: Minimize verbs ending with
   "ing": "This is necessary to provide...", not "This is necessary for


Mime
View raw message