MSDN Archive Home
Help and FAQs
WCF Event Publishing
All Resource Updates
Create New Discussion
Please Stop using the "My" Prefix in Examples
Mar 18 2008 at 3:48 PM
Would you ever in a million years name an object with the prefix "My" in production code? No. So don't do it in your examples.
Basically you're saying, "Here is an example of how to do something but I personally would never do it that way." It's unprofessional and bad form to make an example that you wouldn't use and it's a REALLY bad teaching method.
This is a major problem in all Microsoft examples. I don't know for a fact but I strongly suspect that interns are tasked with writing the examples and while a Microsoft intern is probably one of the smartest interns on the face of the planet they clearly don't have any practical experience.
I remember looking up a Microsoft example for using sockets and there was a major bug in the code, I believe it was they didn't wait for the socket to close before exiting the function. This caused my application to hang after it tried to open and close a certain number of sockets. This kind of serious flaw would never be introduced by someone with experience as they would know about this pitfall and would have absolutely mentioned it.
It's like you make a car that will explode and catch on fire if you honk the horn three times and turn on the lights but you don't bother telling anyone about it.
Apr 16 2008 at 7:48 PM
Thank you very much for the feedback.
I appreciate your concern about the naming conventions, but the rest of the things which you have mentioned do not seem to relate to that. When you are starting a new thread, kindly make sure that it is meaningful and not just a whole essay where the first line is the only one that matters. :)
About the "My" prefix, i agree to your line of thought but the comment does not seem constructive enough. The focus of this sample was on publishing events through WCF while you are commenting on the naming convention. Anyways I will certainly be careful with the names next time...!! :)
Thanks for your time.
Sign in to post message or set email notifications
Manage Your Profile
MSDN Flash Newsletter
© 2008 Microsoft Corporation. All rights reserved.