Difference between revisions of "Help:Naming an article"

From COLLADA Public Wiki
Jump to navigation Jump to search
({{HelpTOC}})
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{HelpTOC}}
 
Wiki software allows you to turn any text into a link ([[like this]]) to another wiki article.
 
Wiki software allows you to turn any text into a link ([[like this]]) to another wiki article.
  
Line 4: Line 5:
  
 
==Things to consider when naming articles==
 
==Things to consider when naming articles==
*Use simple nouns, names, or short descriptive phrases that would work well in a sentence.   
+
*'''Use simple nouns, names, or phrases''' that would work well in a sentence.   
*Use singulars, not plurals, if at all possible. (This wiki's linking can add plurals easily in most cases but not subtract them.)
+
*'''Use singular''', not plural, if at all possible. (This wiki's linking can add plurals easily in most cases but not subtract them.)
*Use titles that people can find easily in searches and that you can use easily in sentences within other articles.
+
*'''Use words in the titles that people are likely to search for''' and that you can use easily in sentences within other articles.
*This wiki site might end up containing information about multiple products and COLLADA in general, so be specific when you need to be.  
+
*But '''be specific; the title should describe what's in the article.''' This wiki site might end up containing information about multiple products and COLLADA in general, so be specific when you need to be. Examples:
:(For example, titling something [[demo]] would be OK if you were talking about what a demo in general is, but not if you were talking about a specific demo or product. In the latter case, something like [[list of COLLADA demos]] or [[COLLADA demo for SigGRAPH 2006]] would be better.)
+
**[[demo]] is a good title for a description of what a demo in general is, but not for a specific demo or product. In the latter case, something like [[list of COLLADA demos]] or [[COLLADA demo for SigGRAPH 2006]] would be better.
*Avoid punctuation and special characters if possible.
+
**[[Sony]] might be a good title for a description of Sony the company, but not of COLLADA tie-ins provided by Sony. In the latter case, [[COLLADA DOM API]] or [[Sony COLLADA plug-ins]] would be better.
 +
*Avoid gratuitious punctuation and special characters, but use when needed.
  
 
==Examples of useful article titles==
 
==Examples of useful article titles==
Line 25: Line 27:
 
*View [[Special:Allpages|the list of all existing article titles]]. See which ones make sense to you and which seem to make reasonable titles.
 
*View [[Special:Allpages|the list of all existing article titles]]. See which ones make sense to you and which seem to make reasonable titles.
  
[[Category:Help]]
+
==See also==
 +
*[[Help:Renaming an article]]
 +
 
 +
[[Category:Help|Naming wiki articles]]

Latest revision as of 04:42, 12 May 2007

Help
Wiki

About (overview)
Search
FAQ
Help

Navigation

Portals
Categories
Searching

Editing

Basic editing
Article names
Adding article
Formatting
Linking
Tables
Redirects
Deleting
Copying
Images

Policies and guidelines

Standard article layout
Review edits, spam
Bugs

COLLADA

FAQ
Tutorials

Wiki software allows you to turn any text into a link (like this) to another wiki article.

Here are some tips for naming articles.

Things to consider when naming articles

  • Use simple nouns, names, or phrases that would work well in a sentence.
  • Use singular, not plural, if at all possible. (This wiki's linking can add plurals easily in most cases but not subtract them.)
  • Use words in the titles that people are likely to search for and that you can use easily in sentences within other articles.
  • But be specific; the title should describe what's in the article. This wiki site might end up containing information about multiple products and COLLADA in general, so be specific when you need to be. Examples:
  • Avoid gratuitious punctuation and special characters, but use when needed.

Examples of useful article titles

  • COLLADA: This article could describe COLLADA and you can also just link to it in any sentence about COLLADA. For example:
    "Several companies worked together to develop COLLADA".
  • naming wiki articles: states clearly what it's about and is spelled & phrased so that it can be used in a sentence:
    "Before creating articles here, read more about naming wiki articles."

Examples of bad article titles

To stimulate your thoughts further

See also