Utpal Writes - on a project called life...

What Neatly Written Software Specs Can Do And What It Cannot

by Utpal Vaishnav on August 31, 2009

Software Specs are a form of initial communication. When used neatly, they convey important information in an easy-to-consume way.

Success of any project largely depends on clear and precise communication and Project Specs, inherited (and extended) from vision documents are an important piece of initial communication.

Here is what a neatly written project specs can do:

  1. Effectively describe what is expected.
  2. Help architects and analysts to clarify decisions by compelling them to be specific.
  3. Provide a room for review, questioning and discussion for details before the execution stage.
  4. Keeps everyone on the same page.
  5. Creates a team-wide point of reference for specific plans.
  6. Schedule milestone(s) to focus
  7. Serves as insurance for either side against getting hit by the bull!
  8. Creates and improves an environment where healthy discussions can happen.
  9. Provide opportunity to give and take feedback.
  10. Set the Quality Expectations.
  11. Help implant saneness and confidence into the team.

At the same time, it is important to know what cannot be covered by software specs. Here is the list:

  1. It cannot eliminate all discussions between team members and stakeholders.
  2. It cannot act as a proof to show how stylish the author is
  3. It cannot show the importance of the feature and why it should not be eliminated even though it does not pass feasibility analysis.
  4. It cannot convert developers to a rational point of view.
  5. Be a whiteboard for the author’s Visio, Charting or UML skills

Project Managers can be benefited by sharing (and possibly extend as well) the above list with everyone who are directly or indirectly involved in crafting project specs.

 

See Also:

  1. Zen of Team Handling for Software Projects
  2. Twenty Traits Of Software Project Sponsors Who Have The Power To Screw-up An Offshore Outsourcing Engagement
  3. Leadership Virtues That A Software Project Manager Should Have

Previous post:

Next post: