in

 

Writing an SRS from the business point of view

Last post 05-23-2007 12:47 PM by emarone. 4 replies.
Page 1 of 1 (5 items)
Sort Posts: Previous Next
  • 03-27-2007 7:12 AM

    Writing an SRS from the business point of view

    A Software Requirements Specification (SRS) document or a Detailed Design Specification are technical by design and mainly for IT purposes. Can you recommend related documents that gathers changes in window/screen designs and related business processes (reports, audits, etc.) that are written specifically for the business in the language of the business? For example, this document won't drill down to affected databases, code, tables, mappings, technical jargon, etc. Although I'm currently writing a document that represents the business point of view in these matters, I'm always glad to learn and borrow from the experts.

    Thanks - Charlie  charlie6067

  • 03-27-2007 10:15 PM In reply to

    • emarone
    • Top 10 Contributor
    • Joined on 09-19-2006
    • Seattle, WA
    • Posts 270

    Re: Writing an SRS from the business point of view

    This is a tricky task, trying to be an interpreter between these two sides of the house.  I've worked on a few variations on these hybrid requirements/functional documents over the years.  I have a few questions for you to help make my suggestions a little more focused:

    What is the purpose of the document?  For example, are you trying to capture pre-design requirements, or validate to-be design work that's already in progress for the business users?

    What kind of application (CRM, ERP, PPM, etc) are you trying to document?

    Who is your target audience with this document?  Executives, managers, end users, combinations thereof?

    Erik Marone | Daptiv Product Manager
  • 03-28-2007 8:11 AM In reply to

    Yes [Y] Re: Writing an SRS from the business point of view

    Charlie,

    Here are some requirement doc templates to work with.  These aren't SRSs and my meet your needs. 

    John F. Filicetti, PMP, MBA
  • 04-03-2007 12:28 PM In reply to

    Re: Writing an SRS from the business point of view

    Hi John - many thanks for the templates. My group will study the documents. Looks like what I was searching for. Thanks!

    Hi Erik - thanks for your suggestions. This is about pre-work before any coding starts, near the beginning of the project, basically documenting anything the business expects to see. Examples: screen depictions, reports, audits -- visual stuff plus requirements, exceptions, etc.  The real target group is the end users and testers. Applications can range from client based to mainframe. Except for what John just sent, it's been difficult to find templates like his.

    Thank you both!

    Charlie   charlie6067

  • 05-23-2007 12:47 PM In reply to

    • emarone
    • Top 10 Contributor
    • Joined on 09-19-2006
    • Seattle, WA
    • Posts 270

    Re: Writing an SRS from the business point of view

    Charlie,

    First of all, I apologize for the overly belated follow up, and I hope John's templates were helpful.

    When I've have to create these kinds of documents in the past, a good general rule is to focus on the future state of the project.  If you are performing an upgrade to an existing system or process, a brief statement describing the current state helps put the changes in context.  I like to break things into high-level groups of functionality or business processes, as that is how most users tend to view systems.

    For example, if you are describing the implementation of a new Change Management process in eProject, it might look something like this:

    Current State:  Users fill out a change request Word document and email it to the IT Manager, who coordinates new and outstanding change requests for the weekly change control conference call.  The IT Manager manually updates requesters on the status of open CRs on an ad hoc basis.

    Future State:  Users complete and submit the Change Request intranet webform.  The IT Manager will be automatically notified of the new request via workflow notifications.  A series of global Change Management views in eProject will be created to manage the weekly change control conference call and for requesters to track the ongoing status of their change requests.

    This is typically enough detail for end users to understand the nature of the changes and you can certainly include screenshots, mockups, or workflow diagrams to more clearly illustrate the changes where appropriate.

    If your target audience is functional management or higher, including some kind of value statement or measurement of the impact of work to be done.  Continuing the example above, you might include a statement such as "Using eProject to manage the change control process eliminates the need for the IT Manager to follow up on change requests, which currently consumes an average of 5 hours of her time each week. It also provides a more reliable and accessible archive of historical change requests for our quarterly IT audit."

    For testers, you should include the above summary detail, as well as a detailed description of the to-be workflow and expected outcome so testers know what to expect when their work starts, and how to determine if the actual behavior deviates from the expected outcome.  This kind of scenario-based detail, especially early in the project, will help developers understand how the system will be used, and will generally be enough to write UAT scripts for business users later in the project.

    Finally, if you're not making changes to an existing application or process, simply leave out the Current State elements, however the Future State and value statement elements can work by themselves to give the audience a good understanding of what is being developed and why, and they can validate your ideas and design based on this kind of data.

    Hope these tips are helpful!

    Erik Marone | Daptiv Product Manager
Page 1 of 1 (5 items)

Navigate: Home | Blogs | Forums | Solution Library  Get Help:  Contact | Feedback | FAQ   Terms of Use:  Terms & Conditions | Privacy Policy