Revision #29

You are currently reviewing an older revision of this page.
Go to current version

Table of Contents

General guidelines for (English-language) wiki article titles:
The words you use in your article title are a very important factor in search engine discoverablity.
  • Use title casing (such as "How to Configure Software Distribution"). Do not use sentence casing (such as "How to configure software distribution"). The exception is a quote (see below).
  • It is okay to use lower case in a title when you're referring to an actual message in the UI. In that case, use quotes and the punctuation in the actual message. This can be used to quote a KB article, release note, or error message. For example... SQL Server Troubleshooting: "Reboot your system."
  • Avoid gerund-based titles ("Using," "Understanding," etc.). They can be misleading and ambiguous. If you see a search result with the title "Using MOM", what do you expect to see in the wiki article? Instead of "Adding a Stub Page," call it "Add a Stub Page" or "How to Add a Stub Page".
  • Try to include your technology/product in the title. For example, "How to Troubleshoot" is not helpful. But "How to Troubleshoot SharePoint Server 2010" is much more helpful.
  • For links aggregation or conceptual wiki articles, use simple noun-based titles. For example, "Software Distribution".  
  • For articles that tell how to do something, use  "How to..." For example, "How to Configure Software Distribution". 
  • Commas--per the Microsoft Style Guidelines, use a comma after each item in a list, including the second-to-last item, such as "How to Design, Create, and Maintain a SQL Server Database". You can also use commas in a quoted error message, when the comma is in the UI message.
  • For articles about the TechNet Wiki start the title with "Wiki:..." For example, "Wiki: Title Guidelines".
  • Likewise, for articles about a specific technology, try to include the technology. For example, "Windows Server Portal" or "Windows Server: How to Add a User Account". Otherwise, if the title is too generic (such as "How to Add a User Account") it won't be clear to the reader what the article is about when it is seen in a list or in search results.
  • For nouns or subjects, just title the topic after the subject, such as "SQL Server 2008 R2". Do not include unnecessary words before or after it, such as "Understanding...", "How to Understand...", "Introduction to...", "About...", "A few tips on...", or "...Overview".
  • If the version of the technology or product is important to the article, use the version number in the title.  
  • If the article pertains to multiple products, see if you can exclude the products from the title and include them in the article instead.
  • Brevity is key. Search engines key on only a certain number of characters in a title, so shorter titles are better than long ones.

See Also

Other Languages

Revert to this revision