Forums for the Business Analyst

 
  Modern Analyst Forums  Business and Sy...  Structured Anal...  When and where to use Functional Specifications, Use Case and Desugn docs
Previous Previous
 
Next Next
New Post 12/28/2011 12:19 PM
User is offline CraigRaj
2 posts
No Ranking


When and where to use Functional Specifications, Use Case and Desugn docs  

 Hi Guys,

There seems to be no guidelines on when a functional specification document, or use case document or s systems design docyument is considered the output that a systems analyst needs to create for the development team to start their coding and the QA team to start writing their test scripts.

There is a lot of overlap between these three broad kind of documents. I believe that a Use case document is used to elicit requirements and display how the actors will interact with the system and how the system responds, kind of the 'What" functionality. The functional specifications will do more or less the same but with a little emphasis put on on the "how"part while the design document lays most of the emphasis on the "how" part.

Is this understanding correct? What are your experences with these documents in terms of how they are used in your organization.

 

Thanks! 

 
New Post 12/28/2011 1:29 PM
User is offline Tony Markos
493 posts
5th Level Poster


Re: When and where to use Functional Specifications, Use Case and Desugn docs  

Hi:

Here the way it is supposed to go.  (How it is twisted around in any given organization is another story.)

Use Case:  Gives the what, but not the what accomplished internally within the system that does not interface with an Actor.  Also, fails to capture the essential interrelationships between the whats (ie the data flows), so alot of the whats are often missed.

Functional Spec:  Gives the whats.  It is not supposed to give the hows.  Use Cases, Data Flow Diagrams, etc., can be, in a more Agile environment, the functional specs, with the details being handled in conversations between developers. 

The design document  gives the how part.

Tony

 

 

 

 
New Post 12/28/2011 1:47 PM
User is offline CraigRaj
2 posts
No Ranking


Re: When and where to use Functional Specifications, Use Case and Desugn docs  

 Thanks Tony. So basically my understanding of the three seems to be in line with what you think too. Will appreciate to hear from others also.

Thanks!

 
New Post 12/30/2011 11:57 AM
User is offline Sandy
74 posts
8th Level Poster




Re: When and where to use Functional Specifications, Use Case and Desugn docs  

Craig,

It may help to think of functional specs, use cases, and other artifacts as tools - the decision of which tool to use may be influenced by a number of different factors such as:

  • How familiar are project team members with each type of documentation (this includes business team participants, as well as developers, BA's, testers, etc.)?  There is nothing to say that you can't introduce a new type or format for documentation - but if you do, then you may need to consider additional time in the project schedule, potential training sessions or material, etc.
  • What is the scope and volume of the requirements to be documented?  A 250-page functional spec may not be as useful as 25 10-page use cases...
  • What standards, templates, or models / examples exist within your organization?  Use cases are a UML artifact, so if you are following that methodology then you would want to utilize that standard artifact.  However, you can still choose to create use cases even if you are not using UML.  But it's generally valuable to leverage any existing resources available to you - so it never hurts to see if there is a good format that has previously been used in your organization.
  • Who is reviewing and/or approving your requirements documentation?  If you have different reviewers and/or approvers for different sub-sets of your requirements, then a single functional spec might not work as well.  You might still choose a functional spec format, but split it into different documents for each functional area.
  • Are you utilizing an iterative / agile methodology, with multiple cycles for building and testing the system?  If so, it could be very difficult to manage the requirements that are being delivered in each cycle within a single functional spec.

Just a follow-up to the reply from Tony as well.  Any requirements artifact - whether use case, functional spec, process model, etc. - has a specific purpose and meaning.  Use cases are not intended to document information flows, so they're not really 'missing' what they are not intended to accomplish.  Whichever format you choose for your requirements, you may want to consider what other supporting documentation might be needed for a given project.  Check out the 'Articles' section of Modern Analyst - there are some good articles on decision models as a way to elicit and document business rules, and context diagrams as a way to illustrate information flows at the system level.  Also don't forget about non-functional requirements - these are often documented separately in a non-functional spec or a supplementary requirements specification.

Good luck!

Sandy

 
Previous Previous
 
Next Next
  Modern Analyst Forums  Business and Sy...  Structured Anal...  When and where to use Functional Specifications, Use Case and Desugn docs

Community Blog - Latest Posts

Fabricio Laguna talks Business Analysis and AI
I recently connected with Fabricio Laguna, aka The Brazilian BA. Fabricio is a passionate and pioneering business analyst from Brazil. During our conversation, we had a thought-provoking discussion on how artificial intelligence stands to shape the field of business analysis in the years ahead. While AI promises to transform many aspects of busines...
Business Architecture, Ontology and More with Terry Roach
It's been a privilege meeting Terry Roach, a visionary in the field of enterprise architecture and business architecture. Terry's insights into the evolution of business models, the importance of ontology in architecture, and the potential of AI to shape our future were not only thought-provoking but also a reflection of his extensive exper...
Today I had the pleasure of chatting to Jignesh Jamnadas, Chief Operations Officer at Mosaic, about his Blueprints for Success. As a Senior Finance and Operations Executive, Jigs (as he is known to many) has a holistic understanding of all facets of business and a flair for managing both people and processes. Having worked with Jigs, I was struc...

 



Upcoming Live Webinars




 

Copyright 2006-2024 by Modern Analyst Media LLC