Welcome to MSDN Blogs Sign in | Join | Help

View This Blog In

MSDN Wiki Beta

I have always thought that the bulk of the information for any of our product is generated by the community and customers.  Unfortunately, there isn’t any easy way to share the large amounts of valuable information (golden nuggets of information) with the community at large, alongside the product documentation.

 

Today, I am pleased to announce the availability of the beta version of the MSDN Wiki - our first step towards allowing customers to contribute to Microsoft’s developer documentation. 

 

In the MSDN Wiki beta, you can add code samples and content directly alongside the Visual Studio 2005 and the .NET Framework 2.0 documentation in a Community Content section that we have added to each documentation topic.  Right now the MSDN Wiki site only features English documentation, but we are planning to expand this functionality to the localized documentation in the future.

 

Though we provide a large amount of valuable information with the product, there is just no way that we can document every scenario that every developer is going to be thinking through.  We run into a scale issue.  Enabling the community to be a collaborator and be able to share information with one another in a relatively easy manner scales phenomenally well.   

 

If every Visual Studio developer participates, imagine the wealth of information the community could be sharing in one location!

 

We think of this as the first stage of an on-going evolution of Microsoft’s developer documentation.  In this version we are building a wiki around the Microsoft-provided docs by allowing you to add new content and edit content contributed by others.  We want your feedback about where the project should go next. How important is it that Microsoft provides an official version of the docs that cannot be altered by the community?  For Orcas, should we completely open the documentation to editing?  This is the start of a shift in the process we use to write and publish our developer documentation, and we need your help to determine what approach we should take.

 

You can learn more about the project at the MSDN Wiki team blog

 

Namaste!

Posted: Thursday, June 08, 2006 2:25 PM by Somasegar

Comments

Rob Caron said:

 
 MSDN Wiki!
It’s live! http://msdnwiki.microsoft.com
See Soma’s blog (Announcing...
# June 8, 2006 5:30 PM

Snowball - The Blog said:

# June 8, 2006 5:43 PM

gillcleeren said:

Very nice and useful initiative I reckon.

Although I only took a quick look at the already existing articles, it looks very promising.

# June 8, 2006 5:44 PM

Олег Михайлик said:

Линуксоиды видели такое только в страшном сне. А-а-а!!! Microsoft внаглую берёт
# June 8, 2006 6:23 PM

DeveloperZen.com said:

# June 8, 2006 6:27 PM

Aldo .NET Weblog said:

# June 8, 2006 7:22 PM

Pawel Pabich said:

It sounds good although at the moment you don't support Firefox.
# June 8, 2006 7:52 PM

me said:

I've been waiting for this for a while. I think it has great potential for growth. Thank you very much.
# June 8, 2006 8:47 PM

Tim Anderson said:

# June 9, 2006 3:39 AM

gaidar said:

The only question is what version of MSDN will be shipped on DVDs? And what about moderation of MSDN Wiki Content  by Microsoft?
# June 9, 2006 4:51 AM

frankarr - an aussie microsoft blogger said:


Rob
Caron had been
hinting about it, then Soma broke
the news
MSDN
Wiki is live -- http://msdnwiki.microsoft.com...
# June 9, 2006 6:20 AM

FullMetal said:

This is really a great idea, we all were looking forward to something like this.

THANKS!



While I have not a definitive statement about editability on MS own documentation, I have some preliminary ideas:


- MS official documentation should be editable, but not directly by anyone. There are a lot of MS samples that don't adopt your own coding and security guidelines, and many cryptic statements that should be clarified.


- Since MS code *should* be followed as a guideline, every change to that documentation should be moderated/reviewed by MS or a group of contributors (like mvps) trusted by Microsoft. This is to ensure a high quality level of these changes.


- We should have a separate page for internal discussion on every topic: Wikipedia has a discussion page (example: http://en.wikipedia.org/wiki/Talk:Ghost) where contributors can share ideas about the main content especially if it is controversial without affecting the main page.


# June 9, 2006 6:52 AM

Public Class GeoffAppleby said:

Well, Rob hinted it at it.
Then he hinted more.
And even more.
Then Soma announced it.
Then Rob was...
# June 9, 2006 8:25 AM

dotnetkicks.com said:

Trackback from dotnetkicks.com
# June 9, 2006 12:03 PM

anon-msft said:

Great, but why ANOTHER version of the library for this?  Shouldn't this just be a feature of the existing library?  Oh wait there isn't ONE existing library, you have

http://msdn.microsoft.com/library/
http://msdn2.microsoft.com/library/
http://windowssdk.msdn.microsoft.com/library/
http://msdn.microsoft.com/archive/

and now

http://msdnwiki.microsoft.com

Could this be any more confusing?  I think you need to start cracking the whip a little bit.
# June 9, 2006 4:20 PM

Alex Barnett blog said:

Yesterday Somasegar (who runs the Developer Division at Microsoft) announced the beta version...
# June 9, 2006 5:09 PM

yag: Community and Architecture said:

Soma announced a new project today, the MSDNWiki, which takes our MSDN documentation and adds structured...
# June 9, 2006 5:38 PM

Pick A Bar said:

Personally, I turn to reputable dev blogs when I absolutely positively have to find the right info to solve those intractable coding issues that arise from time to time...then if all else fails, I search the official docs ;). Well,...
# June 9, 2006 5:40 PM

MSDN Wiki Blog said:

I’m super excited about the response to the MSDN Wiki launch.  Much of the response has been positive,...
# June 10, 2006 4:19 AM

Koistya `Navin said:

Great stuff!. Thank you guys for moving in a right direction! ;-)
# June 10, 2006 10:05 AM

Mike Stall's .NET Debugging Blog said:

You've probably already read about the MSDN Wiki Beta on Soma's blog. You can now add information to...
# June 10, 2006 8:21 PM

Rodney said:

I think that this is a fantastic ideas as sometimes the MSDN code samples are not very detailed or incomplete. Moreover, they also sometimes lack real world applicability. So, I applaud the opportunity to learn from other people's experiences as well as share my own.

Opensource communities have been doing this for quite some time. Take a look at PHP.Net as an example. Maybe we can get some tips and ideas from them.
# June 12, 2006 9:14 AM

Tom Elix said:

Do you think this will hurt C# Online.NET-the wiki-based online C# and .NET resource?

http://wiki.csharp-online.net/
http://blog.csharp-online.net/
http://forum.csharp-online.net/
# June 12, 2006 9:52 AM

Jeff Stong said:

This is all over the Microsoft blogs: so if you're following them you've no doubt already seen this (more...
# June 12, 2006 9:57 AM

Jeff Stong said:

This is all over the Microsoft blogs: so if you're following them you've no doubt already seen this (more...
# June 12, 2006 10:01 AM

Nektar said:

I would like to see all the MSDN documentation to be opened for editing. You can't imagine how many bugs I have found in code samples, in the Platform SDK, etc, etc, which I would have fixed easily but I wouldn't. These errors ranged from spelling mistakes to grammatical errors, to lack of clarity to more serious mistakes. Please open up the documentation for editing.
However, be very careful about your urls: currently they are complicated. If I have to go to http://msdnwiki.msdn.microsoft.com/library/wiki/topic.aspx?id=123456789,view=123456789 then I am afraid that I will not go there, the urls are toooooo long. If I were you I would move the MSDN documentation to a new site with an easy navigation (url) structure. Currently, not many people (like students) use MSDN documentation: they find it complex, overloaded, too long and difficult to find. Part of this problem is caused by the long urls and the navigation structure they impose on the MSDN Library site.
# June 12, 2006 2:12 PM

Jens Rieck said:

# June 13, 2006 8:35 AM

Sam Gentile said:

On May 19, 2003, I said "I have always admired Mike's ability to look at the world out there and put...
# June 13, 2006 8:36 PM

Somasegar said:

Several folks have asked about support for the Firefox browswer.  THe MSDN Wiki team has this on their list of workitems and before we RTM, will likely add this support.

- somasegar
# June 14, 2006 5:56 PM

Luis E Valencia said:

It should have sqlserver 2005 documentatio too, for example I created an article that I find very useful and it was a little difficult to implement, this one should be in the library.

# June 14, 2006 11:15 PM

jiangsheng said:

# June 19, 2006 10:54 PM

jiangsheng said:

# June 19, 2006 11:12 PM

lesbian rape said:

Best of all people w can talk...
# June 24, 2006 10:45 AM

Mattias Johansson said:

Argh! No FireFox support. Fix!!
# June 25, 2006 7:42 AM

Somasegar said:

Yes - Firefox support is one of the features currently on plan for getting done soon.  Stay tuned!

- somasegar
# June 25, 2006 12:03 PM

LaRud's place said:

# July 17, 2006 5:11 AM
Leave a Comment

(required) 

(required) 

(optional)

(required) 

Comment Notification

If you would like to receive an email when updates are made to this post, please register here

Subscribe to this post's comments using RSS


Page view tracker