WCSF Contrib Coding Guidelines

Contributors should check back to this page often as these guidelines will likely evolve based on customer input and team discussions.

Namespaces

All code in this project should live under the WCSFContrib namespace.
  • Extensions should live under the WCSFContrib.Extensions namespace under the appropriate subfolder.
    • Composite Web Extensions (i.e. custom WebApplications, Presenters) should live under WCSFContrib.Extensions.CompositeWeb
    • AJAX Extensions should live under WCSFContrib.Extensions.AJAX
    • Silverlight Extensions should live under WCSFContrib.Extensions.Silverlight
  • Custom services should live under WCSFContrib.Services
  • Custom Guidance packages should live under WCSFContrib.GuidancePackages

References

WCSF Contrib projects should reference Microsoft signed copies of Enterprise Library and CWAB assemblies for consistency. However it should be easy for consumers of the code to recompile against unsigned or custom signed copies of the assemblies.

Unit Tests

All contributed code should have high unit test coverage, and the unit tests should be checked into the appropriate place in the code tree.

Documentation and Samples

All submitted extensions should include basic documentation explaining the intended usage scenarios, the available configuration options (if applicable) and the API (if applicable). The documentation should be posted on this CodePlex site in the Documentation section. Samples or QuickStarts demonstrating the use of an extension can be checked into the Samples section of the source control if appropriate.

Last edited May 26, 2007 at 5:02 AM by gblock, version 1

Comments

No comments yet.