Changes

Jump to navigation Jump to search
m
Line 5: Line 5:     
This '''Manual of Style''' has the simple purpose of making things easy to read by following a consistent format — it is a style guide. The following rules do not claim to be the last word on SME Server wiki-style. One way is often as good as another, but if everyone does it the same way, the SME Server wiki will be easier to read and use, not to mention easier to write and edit. In this regard, the following quotation from ''The Chicago Manual of Style'' deserves notice:
 
This '''Manual of Style''' has the simple purpose of making things easy to read by following a consistent format — it is a style guide. The following rules do not claim to be the last word on SME Server wiki-style. One way is often as good as another, but if everyone does it the same way, the SME Server wiki will be easier to read and use, not to mention easier to write and edit. In this regard, the following quotation from ''The Chicago Manual of Style'' deserves notice:
 +
 
:Rules and regulations such as these, in the nature of the case, cannot be endowed with the fixity of rock-ribbed law. They are meant for the average case, and must be applied with a certain degree of elasticity.
 
:Rules and regulations such as these, in the nature of the case, cannot be endowed with the fixity of rock-ribbed law. They are meant for the average case, and must be applied with a certain degree of elasticity.
   Line 16: Line 17:  
The following are the preferred naming conventions:
 
The following are the preferred naming conventions:
   −
*Name: SME Server
+
*Name: Koozali SME Server
*Full: SME Server 8
+
*Full: Koozali SME Server 10
*Abbreviated Release SME8
+
*Abbreviated Release SME10
*Point Release: SME Server 8.#
+
*Point Release: Koozali SME Server 10.#
    
The version number or point release number should only be used where the text refers to a action/process that is specific to that release or point release, SME Server in all other instances.
 
The version number or point release number should only be used where the text refers to a action/process that is specific to that release or point release, SME Server in all other instances.
Line 34: Line 35:     
As a general rule, do not put links in
 
As a general rule, do not put links in
# the bold reiteration of the title in the article's lead sentence or
+
 
# any section title.
+
#the bold reiteration of the title in the article's lead sentence or
 +
#any section title.
 +
 
 
Also, try not to put other phrases in bold in the first sentence.
 
Also, try not to put other phrases in bold in the first sentence.
    
Follow the normal rules for italics in choosing whether to put part or all of the title in italics.
 
Follow the normal rules for italics in choosing whether to put part or all of the title in italics.
   −
==== Singular vs. Plural ====
+
====Singular vs. Plural====
 
It is better to name an article in the singular instead of plural notation, because it is easier to add plurality later in a sentence instead of removing it with a pipe.
 
It is better to name an article in the singular instead of plural notation, because it is easier to add plurality later in a sentence instead of removing it with a pipe.
    
<nowiki>[[Contrib]]s</nowiki> is easier to maintain than <nowiki>[[Contribs|Contrib]]</nowiki>
 
<nowiki>[[Contrib]]s</nowiki> is easier to maintain than <nowiki>[[Contribs|Contrib]]</nowiki>
   −
==== Upper case/lower case/mixed case ====
+
====Upper case/lower case/mixed case====
 
Mediawiki automatically "uppers" article names. Every letter after the first, however, is case sensitive. To make your articles easier to link inline to those of others, use lowercase for the rest of the article unless it is a proper noun.
 
Mediawiki automatically "uppers" article names. Every letter after the first, however, is case sensitive. To make your articles easier to link inline to those of others, use lowercase for the rest of the article unless it is a proper noun.
   Line 51: Line 54:     
{| border="1" cellpadding="2" cellspacing="0"
 
{| border="1" cellpadding="2" cellspacing="0"
! What it looks like !! What you type
+
!What it looks like!!What you type
 
|-
 
|-
| For example, it is easier to link to a sentence about [[contrib]]s than to link to one about [[Contribs|contrib]].
+
|For example, it is easier to link to a sentence about [[contrib]]s than to link to one about [[Contribs|contrib]].
| <pre><nowiki>
+
|<pre><nowiki>
 
For example, it is easier to link to a
 
For example, it is easier to link to a
 
sentence about [[contrib]]s
 
sentence about [[contrib]]s
Line 70: Line 73:     
Also note the following:
 
Also note the following:
*Avoid links within headings.
+
 
 +
*Avoid links within headings.
 
*Avoid overuse of sub-headings.
 
*Avoid overuse of sub-headings.
 
*Avoid "The" in headings.  For example, use "Voyage" instead of "The voyage".
 
*Avoid "The" in headings.  For example, use "Voyage" instead of "The voyage".
Line 112: Line 116:  
====Titles====
 
====Titles====
 
''Italics'' should be used for titles of the following:
 
''Italics'' should be used for titles of the following:
 +
 
*Books
 
*Books
 
*Computer and video games
 
*Computer and video games
Line 123: Line 128:     
Italics are generally used for titles of longer works. Titles of shorter works, such as the following, should be enclosed in double quotation marks:
 
Italics are generally used for titles of longer works. Titles of shorter works, such as the following, should be enclosed in double quotation marks:
*Articles, essays or papers  
+
 
*Chapters of a longer work  
+
*Articles, essays or papers
 +
*Chapters of a longer work
 
*Episodes of a television series
 
*Episodes of a television series
 
*Short poems
 
*Short poems
*Short stories  
+
*Short stories
 
*Songs
 
*Songs
   Line 155: Line 161:     
Other examples:
 
Other examples:
 +
 
:Arthur said the situation was "deplorable". (''The full stop (period) is not part of the quotation.'')
 
:Arthur said the situation was "deplorable". (''The full stop (period) is not part of the quotation.'')
 
:Arthur said, "The situation is deplorable." (''The full sentence is quoted; the period is part of the quotation.'')
 
:Arthur said, "The situation is deplorable." (''The full sentence is quoted; the period is part of the quotation.'')
Line 196: Line 203:  
===Usage and spelling===
 
===Usage and spelling===
 
====Usage====
 
====Usage====
 +
 
*Possessives of singular nouns ending in ''s'' may be formed with or without an additional ''s''. Either form is generally acceptable within Wikipedia. However, if either form is much more common for a particular word or phrase, follow that form, such as with "Achilles' heel".
 
*Possessives of singular nouns ending in ''s'' may be formed with or without an additional ''s''. Either form is generally acceptable within Wikipedia. However, if either form is much more common for a particular word or phrase, follow that form, such as with "Achilles' heel".
 
*Abbreviations of Latin terms like "i.e.", "e.g.", or "n.b." should be avoided and English terms such as "that is", "for example", or "note" used instead.
 
*Abbreviations of Latin terms like "i.e.", "e.g.", or "n.b." should be avoided and English terms such as "that is", "for example", or "note" used instead.
Line 211: Line 219:  
====Avoid the second person====
 
====Avoid the second person====
 
Use of the second person ("you") is generally discouraged.  This is to keep an encyclopedic tone, and also to help clarify the sentence.  Instead, refer to the subject of the sentence, for example:
 
Use of the second person ("you") is generally discouraged.  This is to keep an encyclopedic tone, and also to help clarify the sentence.  Instead, refer to the subject of the sentence, for example:
 +
 
*"When ''a player'' moves past "go," ''that player'' collects $200."
 
*"When ''a player'' moves past "go," ''that player'' collects $200."
**Or, even better: "Players passing 'go' collect $200."  
+
**Or, even better: "Players passing 'go' collect $200."
 
*'''Not:''' "When ''you'' move past "go," ''you'' collect $200."
 
*'''Not:''' "When ''you'' move past "go," ''you'' collect $200."
 +
 
This does not apply to quoted text, which should be quoted exactly.
 
This does not apply to quoted text, which should be quoted exactly.
   Line 230: Line 240:  
===Bulleted items===
 
===Bulleted items===
 
These line item lists use the following guidelines:
 
These line item lists use the following guidelines:
 +
 
*Complete sentences should use punctuation and an ending period.
 
*Complete sentences should use punctuation and an ending period.
 
*Incomplete sentence do not need terminal punctuation.
 
*Incomplete sentence do not need terminal punctuation.
Line 246: Line 257:  
Finally, do not be afraid to create links to pages you know do not exist yet; these can serve as hints to people as to what pages it would be useful to create.  If you create such a page, though, be mindful that the phrasing someone used in creating a link might not be the best choice of article title; you may have to change the original writer's link into a [[piped link]] before clicking through it to create the article.
 
Finally, do not be afraid to create links to pages you know do not exist yet; these can serve as hints to people as to what pages it would be useful to create.  If you create such a page, though, be mindful that the phrasing someone used in creating a link might not be the best choice of article title; you may have to change the original writer's link into a [[piped link]] before clicking through it to create the article.
   −
=== 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 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.
   Line 261: Line 272:     
====Formatting issues====
 
====Formatting issues====
Formatting issues such as font size, blank space and color are issues for the Wikipedia site-wide style sheet and should not be dealt with in articles except in special cases. If you absolutely must specify a font size, use a relative size i.e. <code>font-size: 80%</code>; not an absolute size, for example, <code>font-size: 4pt</code>. Color coding of information should not be done, but if necessary, try to choose colors that are unambiguous when viewed by a person with color blindness. In general, this means that red and green should not both be used. Viewing the page with Vischeck ([http://www.vischeck.com/vischeck/vischeckURL.php http://www.vischeck.com/vischeck/vischeckURL.php]) can help with deciding if the colors should be altered.
+
Formatting issues such as font size, blank space and color are issues for the Wikipedia site-wide style sheet and should not be dealt with in articles except in special cases. If you absolutely must specify a font size, use a relative size i.e. <code>font-size: 80%</code>; not an absolute size, for example, <code>font-size: 4pt</code>. Color coding of information should not be done, but if necessary, try to choose colors that are unambiguous when viewed by a person with color blindness. In general, this means that red and green should not both be used. Viewing the page with Vischeck (http://www.vischeck.com/vischeck/vischeckURL.php) can help with deciding if the colors should be altered.
    
====Make comments invisible====
 
====Make comments invisible====
Line 271: Line 282:     
For example, the following:
 
For example, the following:
:<code>hello &lt;!-- This is a comment. --&gt; world<br/></code>
+
 
 +
:<code>hello &lt;!-- This is a comment. --&gt; world<br /></code>
 +
 
 
is displayed as:
 
is displayed as:
   Line 282: Line 295:  
====Legibility====
 
====Legibility====
 
Consider the legibility of what you are writing. Make your entry easy to read on a screen. Make judicious use of devices such as bulleted lists and bolding. More on this has been written by Jakob Nielsen in [http://www.useit.com/alertbox/9710a.html How Users Read on the Web].
 
Consider the legibility of what you are writing. Make your entry easy to read on a screen. Make judicious use of devices such as bulleted lists and bolding. More on this has been written by Jakob Nielsen in [http://www.useit.com/alertbox/9710a.html How Users Read on the Web].
<noinclude>----
+
<noinclude>
[[Category:Help|Manual of Style]]</noinclude>
+
----
 +
[[Category:Help|Manual of Style]]
 +
</noinclude>

Navigation menu