Dr. Dobb's is part of the Informa Tech Division of Informa PLC

This site is operated by a business or businesses owned by Informa PLC and all copyright resides with them. Informa PLC's registered office is 5 Howick Place, London SW1P 1WG. Registered in England and Wales. Number 8860726.


Channels ▼
RSS

.NET

MSDN Wiki: What's Up?


DDJ: Is there a point at which the MSDN Wiki will replace the traditional MSDN documentation? I know that if you're in Visual Studio right now and you hit F1 to go into the help, it's not the MSDN Wiki that you go to. Currently, the MSDN Wiki is a copy of the MSDN documentation, and it's in a different location on the Web.

Rob: Today, MDSN Wiki is a complete duplication of all the Visual Studio 2005 product documentation. That's an artifact of it being developed in its own little sandbox. Today, if you do a search on Windows Live or your favorite Web search engine, you wouldn't find any of the MSDN Wiki content. We've purposely blocked robots, spiders, and so on, because we'd end up getting duplicate hits on every single piece of content. But, the goal is to merge those two into the same content.

It's not a matter of the Wiki replacing the existing online content, or the online content going away. Basically it's just making one set available that will let search engines index it, and link to actual community content on MSDN Wiki. The success of MSDN Wiki to date is entirely the result of word of mouth and people blogging about it, because you can't find it by searching for it. In just the last two months, the number of people going out of their way to put the content on the Wiki is pretty remarkable. Once that content starts showing up in search engine results we're going to see a spike in the amount of contributions happening to MSDN Wiki.

DDJ: Yeah, I could imagine that you might see a 5 or 10 X increase in contributions. Based on what you're saying, right now if you don't already know it's there, you're not likely to find it. That's about to change.

Rob: Right.

DDJ: You mentioned that you're not currently seeing problems with vandalism, but again, when it goes public, you might see those kinds of problems appear.

Rob: Right, and that's part of the risk of having a publicly accessible Wiki. It just goes with the territory.

DDJ: Have you disclosed any time frame for when the MSDN docs switch over to MSDN Wiki?

Molly: The current plan is that in December we will have the current MSDN Wiki English content merged into with the main MSDN Library. From there, the functionality will sort of graduate to other documentations sets. I've gotten a lot of questions about, "When can I have this?" Basically it's all coming gradually starting in December.

DDJ: Right now, the contributors are almost all insiders, people who know it's there. Then, it will go public and the Visual Studio/.NET Framework docs will include the "Community Content". Assuming that's successful, and as you iron out any problems, you'll expand it out to more and more document sets, until, I'm guessing, that this is just the way Microsoft does documentation going forward? Is that too broad of a swath?

Rob: No, it's actually fairly accurate. The other thing that's going on in parallel with all this is that MSDN and TechNet are both undergoing a transition in the publication system that they're using. People are probably familiar with the MSDN2 version of the library. That is a version of those product documents published in the new publishing system. MSDN Wiki uses the new publishing system that MSDN2 uses, so the only content that we can provide the Wiki for today is content that exists in that new publishing system, and that's actually what limits which document sets can be part of MSDN Wiki.

DDJ: I see, so until you get more document sets running on that engine, you can't really Wiki-enable them. Once you do, it becomes almost automatic to provide the Wiki functionality.

Rob: Right, there's basically nothing that blocks us technically at that point.


Related Reading


More Insights






Currently we allow the following HTML tags in comments:

Single tags

These tags can be used alone and don't need an ending tag.

<br> Defines a single line break

<hr> Defines a horizontal line

Matching tags

These require an ending tag - e.g. <i>italic text</i>

<a> Defines an anchor

<b> Defines bold text

<big> Defines big text

<blockquote> Defines a long quotation

<caption> Defines a table caption

<cite> Defines a citation

<code> Defines computer code text

<em> Defines emphasized text

<fieldset> Defines a border around elements in a form

<h1> This is heading 1

<h2> This is heading 2

<h3> This is heading 3

<h4> This is heading 4

<h5> This is heading 5

<h6> This is heading 6

<i> Defines italic text

<p> Defines a paragraph

<pre> Defines preformatted text

<q> Defines a short quotation

<samp> Defines sample computer code text

<small> Defines small text

<span> Defines a section in a document

<s> Defines strikethrough text

<strike> Defines strikethrough text

<strong> Defines strong text

<sub> Defines subscripted text

<sup> Defines superscripted text

<u> Defines underlined text

Dr. Dobb's encourages readers to engage in spirited, healthy debate, including taking us to task. However, Dr. Dobb's moderates all comments posted to our site, and reserves the right to modify or remove any content that it determines to be derogatory, offensive, inflammatory, vulgar, irrelevant/off-topic, racist or obvious marketing or spam. Dr. Dobb's further reserves the right to disable the profile of any commenter participating in said activities.

 
Disqus Tips To upload an avatar photo, first complete your Disqus profile. | View the list of supported HTML tags you can use to style comments. | Please read our commenting policy.