Partager via

Do You Hate Bad Documentation?

  • Article

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.

Comments