Ken Brubaker

The ClavèCoder

<July 2008>
SuMoTuWeThFrSa
293012345
6789101112
13141516171819
20212223242526
272829303112
3456789


Navigation

Subscriptions

News

Kenneth Brubaker
Senior Application Architect

Locations of visitors to this page

Post Categories



Friday, February 20, 2004 - Posts

A compilation of new .NET Design Guidelines

Update:
Care and feeding of DateTime

For my own reference, I thought I'd compile a quick list of design guidelines added by Brad Abrams, et al. I strongly urge architects to adopt the .NET Design Guidelines for Class Library Developers, especially since a subset of the guidelines is an international standard. That's packing a lot of lead, in my opinion. I'll try to keep this updated so I can keep a link to just this entry.

Consider: The Do's and Don't's entry is there to encourage architects to use the same format as the class library guidelines in their addendums to the guidelines.

Here's the list

Do’s and Don’t’s
Death to SCREAMING CAPS
Exception Message Guidelines
Use the Core suffix rather than Impl
Don’t use Enum.IsDefined for ArgumentOutOfRangeException
Use Id not ID
Use abstract base classes, and without the Base suffix for type inheritance

Advanced Topics

Discussion on the ParamsAttribute method overload guideline
CLR Hall of Shame, ArgumentNullException
Why have naming conventions?
The difference between CLS and the Design Guidelines
Research on casing
Explicit interface member implementation guidelines
Hashcode guidelines
The utility of exceptions
Care and feeding of DateTime

posted Friday, February 20, 2004 6:45 AM by kenbrubaker with 3 Comments




Powered by Dot Net Junkies, by Telligent Systems