Wiki Life: What do you put in the Other Resources section? Should every article have one?


This is a continuation of my previous blog posts in this series, Navigational Guidelines: 

  1. Wiki Life: What are in-line links?
  2. Wiki Life: What do you put in the See Also section? Should every article have one?

      

This topic (Other Resources) is part of the UX Guidelines section, Links and Accessibility.

Here are the different link guidelines:

  • Article table of contents
    • This is the "In this article" section under the introduction section.
    • See Page Layout above for detailed instructions on how to create this section.
  • 'Return to Top' links
    • These links exist at the bottom of every section (above the horizontal rule) and link back up to the very top of the article (and not just the TOC).
  • In-line links
    • In the introduction section, include an embedded link (when possible) to the parent topic.
  • <Product Name> Wiki Pages section
    • Pull it into a Portal page if >10 links.
  • See Also section
    • This is a link list at the bottom that links to domain parent articles (and related articles) in TechNet Wiki.
  • Other Resources section
    • These are the external links, including links to Microsoft and TechNet sites that are non-Wiki.
  • References section
    • Use this section if you pulled source material and ideas from other sites, blogs, or forums. Make sure you have permission from authors to use their material.
  • TechNet Resources section
    • This list is specific to TechNet resources found on the topic. 

      

The Other Resources section is a list of links that are external to TechNet Wiki. If you have links to TechNet Wiki articles, they should go in the See Also section, which comes above the Other Resources section. See Wiki Life: What do you put in the See Also section? Should every article have one?

Similar to the See Also section, the Other Resources section should be an H1.

     

Should every article have an Other Resources section?

Yes! Honestly, it would be best to make sure each article has a See Also section first (see this blog post for ideas), but every article would benefit from an Other Resources section and should have one.

For every article, there are a lot of links that should be included.

Here are some examples of types of links you should include:

  1. Microsoft official marketing page for that technology (example: https://www.visualstudio.com/
  2. MSDN/TechNet Forum (parent forum link)
  3. MSDN/TechNet Forum answers 
  4. Other forum answers (Stack Overflow or technology-specific forums)
  5. Related Microsoft Connect or User Voice feedback 
  6. MSDN/TechNet Library parent articles (the main Help documentation for that product)
  7. MSDN/TechNet Library related articles (articles in that technology section that are related to your scenario)
  8. MSDN/TechNet Blog official site for that product
  9. Related MSDN Gallery/TechNet Gallery/CodePlex/GitHub items
  10. Visual Studio and MSDN Magazine articles 
  11. Related MSDN/TechNet Blog posts by other teams and Microsoft employees
  12. Related non-MS blog posts (WordPress, Blogger, etc.) from MVPs, other partners, and other customers
  13. Related YouTube videos
  14. Related Twitter feeds 
  15. Wikipedia articles when a concept needs a definition

 

What other types of links should be included in the Other Resources section? Comment with your thoughts!

What are some good articles that should be examples that have great Other Resources sections? Comment with the URL!

 

Come on in! The Wiki is warm!

   – Ninja Ed

Comments (11)

  1. Danish Islam says:

    Good share. Thanks.

  2. Great article Ed. I always learn some new tips from these types of articles.

    Some other potential references to list:
    – Twitter feeds
    – Visual Studio and MSDN Magazine articles
    – MSDN Forum answers

  3. Shanky_621 says:

    Ed hope you are still there on this thread. I pinged and mailed you on your MS id I have requested fellow MVP’s to become judge in Technet Wiki Comp and they have agreed I would like to discuss further can you please mail me at shanky21smat@hotmail.com.

    Thanks

  4. Chervine says:

    Thanks for sharing Ed!

  5. I think all articles should have an Other Resources section. I can’t think of any topic that is so new that it hasn’t been touched on elsewhere. I include:
    Microsoft library and kb articles.
    gallery scripts.
    pages on my web site, when they are the original source for the topic (re-written for the Wiki).
    Forum posts, where the idea originated, or the topic was discussed.
    blog posts.
    Wikipedia articles (very rare) when a concept needs a definition.
    Microsoft Connect feedback (very rare).

  6. Saeid Hasani says:

    Thanks Ed for sharing the great posts! I was enjoyed two former pots of this series(Navigation)!

    I absolutely agree with Richard, there are so many technical writers around the world which probably wrote about the concept which we want to write about. We have to spend a little tile to find some of them and have to add them in our articles even they are
    on the opposite side of our ideas!

  7. Thanks everyone!

    Thanks, Ken, I’ll add those ideas!

  8. Shanky, sorry about that. (We caught up in Skype.)

  9. You’re welcome, Chervine! Let’s get the word out and encourage more folks to build out Other Resources sections!

  10. Richard, that’s a good point. Every topic at least has some technology library article, marketing article, forum, or blog about it.

  11. Richard, those are some good ideas. I’ll add Wikipedia and Microsoft Connect (and clarify the different forum scenarios).

Skip to main content