Changes

Jump to navigation Jump to search
m
Line 209: Line 209:     
====Avoid self-referential pronouns====
 
====Avoid self-referential pronouns====
Most SME Server wiki articles should not be based on one person's opinions or experiences -- except for HowTos.  Thus, "I" can never be used, except, of course, when it appears in a quotation. For similar reasons, avoid the use of "we" and "one", as in: "We/One should note that some critics have argued in favor of the proposal", as it sounds more personal than encyclopedic.
+
Most Koozali SME Server wiki articles should not be based on one person's opinions or experiences -- except for HowTos.  Thus, "I" can never be used, except, of course, when it appears in a quotation. For similar reasons, avoid the use of "we" and "one", as in: "We/One should note that some critics have argued in favor of the proposal", as it sounds more personal than encyclopedic.
    
Nevertheless, it might sometimes be appropriate to use "we" or "one" when referring to an experience that ''anyone'', any reader, would be expected to have, such as general perceptual experiences. For example, although it might be best to write, "When most people open their eyes, they see something", it is still legitimate to write, "When we open our eyes, we see something", and it is certainly better than using the passive voice: "When the eyes are opened, something is seen".
 
Nevertheless, it might sometimes be appropriate to use "we" or "one" when referring to an experience that ''anyone'', any reader, would be expected to have, such as general perceptual experiences. For example, although it might be best to write, "When most people open their eyes, they see something", it is still legitimate to write, "When we open our eyes, we see something", and it is certainly better than using the passive voice: "When the eyes are opened, something is seen".
Line 258: Line 258:     
===External linking===
 
===External linking===
Wikipedia, as a policy, prefers author/editors to group external links at the bottom of an article, in a named section. The SME Server wiki, as policy, does not care. If you want to use an external link in-line under a descriptive piece of a sentence, knock yourself out.
+
Wikipedia, as a policy, prefers author/editors to group external links at the bottom of an article, in a named section. The Koozali SME Server wiki, as policy, does not care. If you want to use an external link in-line under a descriptive piece of a sentence, knock yourself out.
    
===Miscellaneous notes===
 
===Miscellaneous notes===
 
====When all else fails====
 
====When all else fails====
If this page does not specify which usage is preferred, use other resources, such as ''The Chicago Manual of Style'' (from the University of Chicago Press) or Fowler's ''Modern English Usage'' (3rd edition) (from the Oxford University Press). Also, please feel free to carry on a discussion on [[SME Server talk:Manual of Style|the style guide's talk page]], especially for substantive changes.
+
If this page does not specify which usage is preferred, use other resources, such as ''The Chicago Manual of Style'' (from the University of Chicago Press), Fowler's ''Modern English Usage'' (3rd edition) (from the Oxford University Press) or the ''Oxford Style Guide'' (also from the Oxford University Press). Also, please feel free to carry on a discussion on [[SME Server talk:Manual of Style|the style guide's talk page]], especially for substantive changes.
    
Even simpler is to look at an article that you like and open it for editing to see how the writers and editors have put it together. You can then close the window without saving changes if you like, but look around while you are there. Almost every article can be improved.
 
Even simpler is to look at an article that you like and open it for editing to see how the writers and editors have put it together. You can then close the window without saving changes if you like, but look around while you are there. Almost every article can be improved.
 +
 +
Note that contributions to the wiki come from users of different dialects of English, or non-native speakers, so some variation in usage is natural, expected, and not to be considered erroneous.
    
====Keep markup simple====
 
====Keep markup simple====

Navigation menu