International School of Engineering Web Software development Development Decoded
Home Products Allmostapp Testimonials About Us
one pix   one pix   | |
Project Management  
Bookmark and Share
Add to Technorati Favorites

The most important requirement for a successful project is to define requirements clearly… No, we are not playing with words (Part 1)

This entry is part 5 of 13 in the series Software Project Development Made Simple and Scientific

Previous Article in this Series
You have the right people and the right processes to manage projects but… What next?


Requirements Gathering and Analysis

Dilbert.com

This is the first step in software development but a very crucial step for the success of the project. According to surveys by the Standish Group, 20-25% of projects fail (or are challenged… never mind the terminology… just know that either the vendor and/or the customer is adversely impacted, and that is bad) due to poorly defined requirements.

Requirements must be absolutely clear and signed off by you and the customer.

You must also clearly define what is in scope and what is not to avoid any communication issues later on.

For example, if a requirement is to install and configure a third-party component, it must be agreed upon that issues in the third-party component are not in scope.

This will also help in agreeing on Change Requests, if and when they are requested (it is more likely to be IF than WHEN).

Basecamp is a very simple and powerful tool that can be used for collaborating on requirements and changes. For that purpose, it can and should be used as an alternative to email for all communication needs.

Deskaway is another option for doing the above and seems to have been heavily influenced by Basecamp.

The Writeboards option of Basecamp or the Docs option of Deskaway can be used for documenting the requirements and the functional specs derived from that. This helps maintain versions and can be easily referred to when change requests are discussed.

Celeroo will shortly announce an offering that will help develop web applications cheaper, faster and better. Requirements management will be integral to it in ways different from the above solutions as they deal more with project collaboration and Celeroo deals with software development.

You can subscribe to our newsletter to receive updates on launch dates, features, benefits etc., in addition to notifications on updates in this course.

To maximize the benefits, you should document the requirements and the resulting detailed functional spec such that each sentence (except for summaries) is numbered separately in a hierarchical structure.

For example, requirements should be numbered as:

1. Requirement 1
2. Requirement 2
3. Requirement 3
4. Requirement 4
5. Requirement 5

…and so on.

And, features should be numbered as:

1. Feature 1
2. Feature 2
2.1 Sub-feature 1 of Feature 2
2.2 Sub-feature 2 of Feature 2
2.2.1 Sub-feature 1 of Sub-feature 2 of Feature 2

…and so on.

It is worth the time to break each module into smaller features and each feature into sub-features.

The complexity must be turned into simplicity using this process. After all, you must take baby steps to reach that distant goal; you cannot just jump and get there in one step.

This will also help plan the project because it is much more difficult to estimate a task written as “Invite a Friend module” than to estimate it if it were broken down into steps such as (assume “Invite a Friend” is task numbered 1):

1.1 Radio buttons to select different mail clients (Yahoo, Gmail, AOL, MSN), and a “Get Email IDs” button.
1.2 When the mail client is selected and the button is clicked to get the Email IDs from the selected mail client, the list of IDs is retrieved from the account after submitting the required login information.
1.3 User can select multiple Email IDs from the list. On clicking the “Submit” button, the selected IDs appear in the text area given above the radio buttons.
1.4 On clicking “Invite”, a predefined Email is sent to the selected IDs. The content of this mail is configurable by the admin.
1.5 The Email contains a link to the registration page of the site.

OR

…to estimate a task written as “Site search with ability to search by Blogs, Forums, etc.” than to estimate it if it were broken down into:

2.1 A search text field and a “Search” button that has a drop down are shown.
2.2 The drop down list shows Categories, People, Communities, Blogs, Photos, Videos, and Forums in the order shown.
2.3 The search text field can take any input (alphanumeric and special characters).
2.4 On clicking the search button without selecting any option from the drop down list, a complete site search is done and a results page is displayed.
2.5 If an option is selected in the drop down list, search is done only within that section.
2.6 If there are no search results meeting the search criteria, a message, “There are no results meeting your criteria. Please try again.” should be shown in an Ajax box with an “X” icon at top right of the box to close it.
2.7 When search is done without selecting an option in the drop down list, the results are segregated according to the options shown in section 2.2. For example, if the search term is present in “Categories” and also in “Blogs”, then the results page displays a heading ” in Categories” and 5 results in that section with “more…” link. Then, it will display another heading ” in Blogs” and 5 results in that section with “more…” link. Clicking on the “more…” links takes the user to the detailed search results page where all the relevant results in that section are displayed.
2.8 The detailed results page must show 30 results in one page (e.g., 30 photos or 30 rows of blog post titles with the blogger’s photo thumbnail, etc.). Pagination must be shown thereafter.
2.9 Pagination must be like in Yahoo! Answers with square boxes around numbers. The current page square box will have a different highlighted color based on the site theme.

Now, you may be using Functional Specs or Use Cases or SRS or combinations thereof to achieve what has been stated above, or if you have embraced Agile, you may be talking in terms of User Stories.

Whatever you do and however you do, ensure that documentation is not overdone and only the absolutely necessary documentation required to achieve the purpose is created.

And if you think this will work only for a Waterfall SDLC process and not for Agile, think again! You simply have to adapt this to your way of working, but the fundamental principles remain the same…

“…Break the complexity down into simplicity”

and…

“…Be Careful! You must strike a balance between going deep into details and the effort and time it takes to do that”

Disclaimer: We are not related to any of the companies offering the software tools we have referred to in this article.


Next Article in this Series
The most important requirement for a successful project is to define requirements clearly…
No, we are not playing with words (Part 2)



Discussion

Comments for “The most important requirement for a successful project is to define requirements clearly… No, we are not playing with words (Part 1)”

 
OUR PRODUCTS
Celeroo Req 'n Spec
Smartest Way To Manage Requirements And Changes For Any Software Project   more
 
Free Trial Req 'n Spec
Celeroo Builder
Cheapest And Fastest Way To Build PHP Applications   more
 
Free Trial Builder
Celeroo Frame
Lean, Flexible And Transparent MVC PHP Framework       more
 
Download Frame

Subscribe to "Allmostapp: Empowering BAs to Build Apps from Ideas - Swiftly"

We will NOT share your info with any third party. PERIOD.
 
right-bg-img right-bg-img
  Who We Are | Contact Us  
  All Rights Reserved. Copyright © 2008 - 2014 International School of Engineering. Celeroo’s Blog and Training Center . Entries (RSS) Search Unleashed wordpress-email-newsletter-plugin-for-double-opt-in-subscription G Lock Powered by WordPress Theme by The Masterplan