Welcome to MSDN Blogs Sign in | Join | Help

Do You Hate Bad Documentation?

I hate bad documentation.  Right now though, I'm busy writing up some topics about WCF channels in my spare time for the Windows SDK.  After a few weeks of doing this, it's starting to get pretty tough deciding whether things are just right, neither too little nor too much description, so that your questions are answered and the answers are easy to find.

And that's when I thought, "Maybe actual customers would like to read some of this and say what needs to be better?"

I'm willing to spend one day a week, every week or two, blogifying some of the very early documentation topics.  This would be prerelease documentation, with even less warrantee than the standard documentation.  There would be only a minimum of technical review and no editorial work.  Batteries not included.  Use only as directed.  May be too intense for some viewers.  If condition worsens, discontinue use and consult a physician.

Let me know what you think about this plan.  Post a comment, use the Email link in the sidebar to send a message, or just contact me directly at nallen@microsoft.com.

Published Monday, March 06, 2006 1:00 PM by Nicholas Allen
Filed under:

Comments

Wednesday, March 08, 2006 10:02 AM by Larry Beck » Blog Archive » [new post]

# Larry Beck » Blog Archive » [new post]

Wednesday, March 08, 2006 10:04 AM by Larry Beck » Blog Archive » WCF SDK Preview

# Larry Beck » Blog Archive » WCF SDK Preview

Monday, March 13, 2006 2:49 AM by Nicholas Allen's Indigo Blog

# Making Sense of Transport Quotas

The results are in and it looks like I'll be going full steam ahead with the plan to post totally unedited...
New Comments to this post are disabled
 
Page view tracker