As Developers, we often forget the user perspective. We forget that we write the docs or samples for users, and not for us. So we "assume" stuff. But if you try to wear the user shoes (or hat for that matter) and go through the docs or samples, you are sure to find so many issues. Many many issues, I assure you.
So always remember the poor users. That is one of the secrets if you want success with open source software. And that is the secret of success with Microsoft.
Comments