This is a work in progress. The User Experience Guidelines exist as an effort to establish basic consistencies across TechNet Wiki. The guidelines are manual (you have to make the changes yourself), and a goal of creating
manual guidelines is to eventually turn some of them into automatic guidelines (that occur automatically through tools) in order to reduce editing and communication around following the guidelines.
In this article:
The title of the article determines the URL of the article. For example, an article is titled "Wiki: Style Guide", which results in a URL of
http://social.technet.microsoft.com/wiki/contents/articles/wiki-style-guide.aspx. Note that spaces become '-' and characters such as ':' are ignored when creating the URL for an article.
For more details, see the
Wiki Title Guidelines.
↑ Return to Top
This article is based on information from <article reference> written by
As Ana mentioned
in this blog post, Wikipedia has this to say about signatures: "When editing a page, main namespace articles should not be signed, because the article is a shared work, based on the contributions of many people, and one editor should not be singled out
above others." - Wikipedia: Signatures
The exception we make, is that we allow the Credits section (see "Credits Section" in "Layouts" above).
However, we want to give you credit for your work... We provide five ways for you to receive credit for your contributions in TechNet Wiki:
↑ Return to Top
Follow these guidelines in order to provide a complete story of Wiki navigation and accessibility. We might try to automate more of these features in the future in order to require less manual work and maintenance.
The related topic of Cross-Linking is discussed in
NOTE: This section includes only brief explanations. For full guidelines and details, see the appropriate bullets in the
Page Layout section above.
↑ Return to Top
To make an article easier to discover using the wiki search, include tags that are relevant to the topic discussed in your article. For example, an article that discusses using SQL Server Express with PHP should be tagged with the 'SQL', 'SQL Express',
and 'PHP' tags.
This section requires more information.
Perhaps change the "In this article" section to use the new [toc] tag?
Kevin, you can if you'd like. I haven't been doing that for articles that opted to do the manual TOCs.
Excellent Article Ed! Just what I'm looking for. :) pkn
Peter and I updated the TOC section and info. Thanks Peter!
Should we call this article "Wiki: Best Practices" instead?
I didn't know this article! And it's all here in one place!
All new Wiki contributors should read this article before its first contribution! I need to make some adjustments in my articles! ^^
If Portuguese articles no longer have the pt-BR tag, how do we find articles in this language?
You probably know this now but others might have this question too... We want the new Portuguese articles to be written on the Portuguese version of TechNet Wiki, and, thus, don't need the tag/title code. There's also a Russian and Chinese version. Thanks!