Help talk:Documentation Guidelines: Difference between revisions From Online Manual

Jump to: navigation, search
No edit summary
Line 1: Line 1:
Should this guide follow the rules for writing documentation? --[[User:AngelinaBelle|AngelinaBelle]] 11:05, 3 December 2010 (EST)
Should this guide follow the rules for writing documentation? --[[User:AngelinaBelle|AngelinaBelle]] 11:05, 3 December 2010 (EST)
== Passive Voice, Active Voice, and "You" ==
I think the [[Wikipedia:Wikipedia:Manual of Style|Wikipedia Manual of Style]] is a reasonably good guide.
[[Wikipedia:Wikipedia:YOU]] has a good example of avoiding You.
There's a secion on contractions.
There is nothing at all on passive or active voice, though there is a section on avoiding instructional style in encyclopedic content. In the "here is what this page does" content, we want to avoid instructional style. In the "how to use this page" content, of course, we want to use instructional style, because passive voice is very awkward for instructional content.
http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Instructional_and_presumptuous_language
--[[User:AngelinaBelle|AngelinaBelle]] 09:01, 28 January 2011 (EST)

Revision as of 14:01, 28 January 2011

Should this guide follow the rules for writing documentation? --AngelinaBelle 11:05, 3 December 2010 (EST)

Passive Voice, Active Voice, and "You"

I think the Wikipedia Manual of Style is a reasonably good guide.

Wikipedia:Wikipedia:YOU has a good example of avoiding You. There's a secion on contractions.

There is nothing at all on passive or active voice, though there is a section on avoiding instructional style in encyclopedic content. In the "here is what this page does" content, we want to avoid instructional style. In the "how to use this page" content, of course, we want to use instructional style, because passive voice is very awkward for instructional content. http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Instructional_and_presumptuous_language

--AngelinaBelle 09:01, 28 January 2011 (EST)



Advertisement: