The Community Blog for Business Analysts


Best Practices - Ad Hoc Procedures

Ad Hoc Procedures

My belief is that software development should be more of a science and contain as little artistry as necessary. It is great to come up with ingenious processes and guidelines for developing your software, but if they impact your colleagues you must get buy-in from everyone who is impacted before you start using them.

Some people achieve satisfaction by getting a compliment for a ‘job well done’, some for a ‘working really hard’ others for ‘being a team player’. Nothing gives me more pleasure than having a colleague answer ‘Yes’ to the question, “Did I make your life easier?”.

Recommended procedures for working with documents should be documented, available and approved by all users of those procedures. Examples of these procedures include:

  • Location of document templates and how to access them.
  • The purpose of the document template and where to enter information into the template.
  • Documentation numbering and versioning conventions.
  • How to check out from and check in to a document repository system.
  • How to use the product or project glossary.
  • The purpose of the styles and properties that are used by a document.
  • The process for baselining, or creating a new version of a document.

Document your procedures and make sure that everyone that needs them understands them and has easy access to their documents.

Further articles will expand upon the obove bullets, with examples.

[1] This was not always the case .. when I first started programming I invented some extremely ingenious and complex software procedures, that I was proud of at the time. I look back at those days and cringe.

Editor's Note: Check out the list of all related best practices.

This entry was published on Mar 18, 2010 / Leslie. Posted in Requirements Management and Communication (BABOK KA). Bookmark the Permalink or E-mail it to a friend.
Like this article:
  1 members liked this article

Related Articles


Leslie posted on Friday, March 19, 2010 2:13 AM
These blogs read a bit terse and out in left-field when read by themselves.
It might help to read preceding articles on best practices starting with:

Only registered users may post comments.

Blog Information

» What is the Community Blog and what are the Benefits of Contributing?

» Review our Blog Posting Guidelines.

» I am looking for the original Modern Analyst blog posts.

Copyright 2006-2019 by Modern Analyst Media LLC