Difference between revisions of "Help:Naming an article"

From COLLADA Public Wiki
Jump to navigation Jump to search
m (Naming wiki articles moved to Help:Naming wiki articles: put into help namespace)
Line 4: Line 4:
  
 
==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==

Revision as of 20:03, 17 April 2007

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