Documenting and enforcing programming standards and guidelines for shared library
Posted
by
dreza
on Programmers
See other posts from Programmers
or by dreza
Published on 2012-02-14T20:19:31Z
Indexed on
2012/03/30
23:41 UTC
Read the original article
Hit count: 470
documentation
|standards
Myself and another developer with the go ahead from our IT director have started a general purpose library in .NET with the intention that it will provide many common purpose classes that we use in our day to day development.
During discussions and design of the library we have come up with a set of standards that we want the library to follow to ensure it is maintained and expanded on in a consistent manner.
What is the best way to ensure these decisions we made for the library get feed to the other developers who might be using and adding to this library in the future. One of our decisions was to ensure we review all checked in code so we expect initially there to be some differences in coding styles of individuals not fitting in with the project standards.
Some ideas I had were:
- Add a Read-me.txt to the project that outline the guidelines and standards
- Send an email out to everyone in the team to let them know about the project etc
- Call a team meeting to go through this new project and our expectations and standards we were aiming to follow
- Try and enforce the standards via Visual Studio (not sure if this would be possible or how just an idea)
At the moment there is no general company programming standards so this would be a first really insofar as we are creating a standard that different project teams would need to adhere to.
© Programmers or respective owner