Thursday, August 31, 2006

Fixed Price Contracts

Few days back Sajjadul Hakim posted a topics in SQA Bangladesh Group about "Fixed Price Contracts". I thought it will be nice to post in this Blog to focus the topics he discussed already. Here a pasted the whole topics with detail URL. Please feel free to discuss on this issue in the SQABD group if you are interested.
____________________________________________________________


Fixed Price Contracts

When does your project start failing? The day you accepted the project.

Most projects worked in Bangladesh are fixed price contracts.

A fixed-price (FP) contract between a provider and a customer defines
the scope, features, planning, timing and price of a software project.
Pretty much everything is fixed, not only the price.

How do you make sure you are not walking into the lion's den? There is
a good article on projects that are based on fixed price contracts,
called "Agile Fixed Price Projects part 1: The Price Is Right". You
can read it here (PDF attached):
http://groups.yahoo.com/group/sqa_bangladesh/files/fixedpriceprojects.pdf

In the following I tried to write a summary with some comments to
influence you to read the entire article. Here goes…


# There is a project in the horizon…Do you qualify…
----------------------------

Question 1: Do I know the domain?
You can't really estimate and develop the software within deadline if
you are new to the domain. The software is all about providing a
solution to the customer. It is very difficult to do that if you have
no experience in the domain.

Question 2: Do I know the technology?
It is not practical to experiment with new technology and tools when
you have a deadline to meet.

Question 3: Can I work with my usual team?
Get the project signed off. Now hire engineers to form the team. This
is a recipe for disaster. You can't really estimate efficiency and
performance of engineers if you haven't worked with them.

Question 4: Can I handle the estimated project size?
If you and your team have worked on short projects, you will be taking
a huge risk undertaking a long project. If you have worked with small
teams, you will be taking a huge risk managing a big team.


# Hooray, you qualify…Should you accept the project…
--------------------------------

Sales tip 1: Don't just respond to "Request For Proposal" (RFP)
Let's talk about our government. Government floats tenders with RFP
document for software projects. Software companies (vendors) submit
their bids based on the instructions in the RFP document. The proposal
contains specification, timing, planning and price. The government
chooses the best proposal (yeah right). Always get more info from the
customer personally before creating the proposal, since the RFPs are
incomplete. You must do this to estimate better.

Sales tip 2: It works both ways
You will have a deadline to meet. That means you will need certain
info and feedback from the customer within certain timeframes or else
you may miss the deadline. So add these conditions in your contract,
i.e. the customer should deliver some information by a certain date;
provide testing feedback within a certain date etc.

Sales tip 3: Don't underbid
If you know how much the project will cost, then don't underbid just
to throw off your competition. How will you compensate for the loss if
you win the project? By giving the customer less than they asked for?
Good luck with that.

Sales tip 4: Add some slack to cover the risks
Your estimates are always flawed. Accept it. Keep buffer time. Don't
cut your buffer to underbid your competitor.

Sales tip 5: Real business requirements
Write the specification with the customer. If the customer is
reluctant to give you enough info, then chances are he will do the
same after you get the project. In any case, you don't have enough
info to estimate. If you go through with it you will probably fail the
deadline.


# Got the job…Rough ride ahead…
--------------------------------

Implementation tip 1: Don't allow change requests
I don't want to comment on this. Better read the entire section in the
document. Here is a quote from the doc: "Don't use Change Requests
because their drawbacks heavily outweigh any initial advantages they
bring"

Implementation tip 2: Spend your slack wisely
Things will go wrong. Prepare for it. Use your buffer time wisely.
Leave some buffer for the end. Usually that's when the heat is on.

Implementation tip 3: Simple, honest and correct tracking
Remember the Green Shift Anti-pattern in one of my previous post? Look
it up here:
http://groups.yahoo.com/group/sqa_bangladesh/message/431

Implementation tip 4: Manage your project
Be proactive. Let the team solve problems with you. Let the team
interact with customers. Stay alert for creeping issues.


Now I am done…for now at least. Deadline oriented projects are always
high risk. The above steps should minimize the risks involved.

This may work for you if you are getting projects abroad. But let's
face facts…you won't really get too many projects that fit all the
criteria in Bangladesh. The author has created another article that
brings a little agility to fixed price contracts. Will post that
later. Thanks.

Regards,
Sajjad


_______________________________________________
source: SQA Bangladesh (www.sqabd.com)

The Green Shift Anti-Pattern

In Dr. Dobb's Agile Newsletter of july 2006, Scott W. Ambler wrote an article about "Green Shift"

The problem is that the project status "green shifted" as it rose through the various levels of management. The people on the ground were very clearly reporting a red project status, our project manager wanted to play it safe so reported yellow status, and his manager was more political yet and reported green status.

In astronomy there is the concept of red-shifting and blue-shifting: red shifting occurs when a body is moving away from you (the wavelength of the light increases) and blue-shifting occurs when a body is moving towards you (the wavelength of the light decreases). This is useful input for determining the speed and direction of something. In software development we have green shifting which occurs when people rework the information contained in status reports to make them more politically palatable to their manager.

A few years ago I was involved with a seriously challenged project. In my weekly status report to the project manager I would very bluntly list all of the problems we were experiencing. Strangely, even though myself and several others were clearly documenting the problems, all of which were out of our control, nothing ever seemed to happen. After a few weeks of this I ran into the CIO and she congratulated me on how well the project was going. I was surprised, and told her that the project was in serious trouble and summarized the critical issues for her. It was news to her.

After a bit of investigation we discovered that although myself and team members had been reporting the serious political challenges that the project team faced, when our project manager summarized our reports he decided to put a better spin on it and reported that the team found the project challenging. His manager in turn reworked it in his report that the team enjoyed the challenges it faced. This was the report which the CIO received.

The problem is that the project status "green shifted" as it rose through the various levels of management. The people on the ground were very clearly reporting a red project status, our project manager wanted to play it safe so reported yellow status, and his manager was more political yet and reported green status.

Other continued pages : 2, 3, 4

Source: http://www.ddj.com , http://fscorner.blogspot.com

Tuesday, August 22, 2006

Software Quality Assurance

              SOFTWARE QUALITY ASSURANCE


A. Concepts and Definitions

Software Quality Assurance (SQA) is defined as a planned and
systematic approach to the evaluation of the quality of and
adherence to software product standards, processes, and
procedures. SQA includes the process of assuring that
standards and procedures are established and are followed
throughout the software acquisition life cycle. Compliance
with agreed-upon standards and procedures is evaluated
through process monitoring, product evaluation, and audits.
Software development and control processes should include
quality assurance approval points, where an SQA evaluation
of the product may be done in relation to the applicable
standards.

B. Standards and Procedures

Establishing standards and procedures for software
development is critical, since these provide the framework
from which the software evolves. Standards are the
established criteria to which the software products are
compared. Procedures are the established criteria to which
the development and control processes are compared.
Standards and procedures establish the prescribed methods
for developing software; the SQA role is to ensure their
existence and adequacy. Proper documentation of standards
and procedures is necessary since the SQA activities of
process monitoring, product evaluation, and auditing rely
upon unequivocal definitions to measure project compliance.

Types of standards include:

Documentation Standards specify form and content for
planning, control, and product documentation and provide
consistency throughout a project. The NASA Data Item
Descriptions (DIDs) are documentation standards (see
Appendix B).

Design Standards specify the form and content of the
design product. They provide rules and methods for
translating the software requirements into the software
design and for representing it in the design
documentation.

Code Standards specify the language in which the code
is to be written and define any restrictions on use of
language features. They define legal language
structures, style conventions, rules for data structures
and interfaces, and internal code documentation.

Procedures are explicit steps to be followed in carrying out
a process. All processes should have documented procedures.
Examples of processes for which procedures are needed are
configuration management, nonconformance reporting and
corrective action, testing, and formal inspections.

If developed according to the NASA DID, the Management Plan
describes the software development control processes, such
as configuration management, for which there have to be
procedures, and contains a list of the product standards.
Standards are to be documented according to the Standards
and Guidelines DID in the Product Specification. The
planning activities required to assure that both products
and processes comply with designated standards and
procedures are described in the QA portion of the Management
Plan.

C. Software Quality Assurance Activities

Product evaluation and process monitoring are the SQA
activities that assure the software development and control
processes described in the project's Management Plan are
correctly carried out and that the project's procedures and
standards are followed. Products are monitored for
conformance to standards and processes are monitored for
conformance to procedures. Audits are a key technique used
to perform product evaluation and process monitoring.
Review of the Management Plan should ensure that appropriate
SQA approval points are built into these processes.

Product evaluation is an SQA activity that assures standards
are being followed. Ideally, the first products monitored
by SQA should be the project's standards and procedures. SQA
assures that clear and achievable standards exist and then
evaluates compliance of the software product to the
established standards. Product evaluation assures that the
software product reflects the requirements of the applicable
standard(s) as identified in the Management Plan.

Process monitoring is an SQA activity that ensures that
appropriate steps to carry out the process are being
followed. SQA monitors processes by comparing the actual
steps carried out with those in the documented procedures.
The Assurance section of the Management Plan specifies the
methods to be used by the SQA process monitoring activity.

A fundamental SQA technique is the audit, which looks at a
process and/or a product in depth, comparing them to
established procedures and standards. Audits are used to
review management, technical, and assurance processes to
provide an indication of the quality and status of the
software product.

The purpose of an SQA audit is to assure that proper control
procedures are being followed, that required documentation
is maintained, and that the developer's status reports
accurately reflect the status of the activity. The SQA
product is an audit report to management consisting of
findings and recommendations to bring the development into
conformance with standards and/or procedures.


D. SQA Relationships to Other Assurance Activities

Some of the more important relationships of SQA to other
management and assurance activities are described below.

1. Configuration Management Monitoring

SQA assures that software Configuration Management (CM)
activities are performed in accordance with the CM plans,
standards, and procedures. SQA reviews the CM plans for
compliance with software CM policies and requirements and
provides follow-up for nonconformances. SQA audits the CM
functions for adherence to standards and procedures and
prepares reports of its findings.

The CM activities monitored and audited by SQA include
baseline control, configuration identification,
configuration control, configuration status accounting, and
configuration authentication. SQA also monitors and audits
the software library. SQA assures that:

Baselines are established and consistently maintained
for use in subsequent baseline development and control.

Software configuration identification is consistent and
accurate with respect to the numbering or naming of
computer programs, software modules, software units, and
associated software documents.

Configuration control is maintained such that the
software configuration used in critical phases of
testing, acceptance, and delivery is compatible with the
associated documentation.

Configuration status accounting is performed accurately
including the recording and reporting of data reflecting
the software's configuration identification, proposed
changes to the configuration identification, and the
implementation status of approved changes.

Software configuration authentication is established by
a series of configuration reviews and audits that exhibit
the performance required by the software requirements
specification and the configuration of the software is
accurately reflected in the software design documents.

Software development libraries provide for proper
handling of software code, documentation, media, and
related data in their various forms and versions from the
time of their initial approval or acceptance until they
have been incorporated into the final media.

Approved changes to baselined software are made
properly and consistently in all products, and no
unauthorized changes are made.

2. Verification and Validation Monitoring

SQA assures Verification and Validation (V&V) activities by
monitoring technical reviews, inspections, and walkthroughs.
The SQA role in formal testing is described in the next
section. The SQA role in reviews, inspections, and
walkthroughs is to observe, participate as needed, and
verify that they were properly conducted and documented.
SQA also ensures that any actions required are assigned,
documented, scheduled, and updated.

Formal software reviews should be conducted at the end of
each phase of the life cycle to identify problems and
determine whether the interim product meets all applicable
requirements. Examples of formal reviews are the
Preliminary Design Review (PDR), Critical Design Review
(CDR), and Test Readiness Review (TRR). A review looks at
the overall picture of the product being developed to see if
it satisfies its requirements. Reviews are part of the
development process, designed to provide a ready/not-ready
decision to begin the next phase. In formal reviews, actual
work done is compared with established standards. SQA's
main objective in reviews is to assure that the Management
and Development Plans have been followed, and that the
product is ready to proceed with the next phase of
development. Although the decision to proceed is a
management decision, SQA is responsible for advising
management and participating in the decision.

An inspection or walkthrough is a detailed examination of a
product on a step-by-step or line-of-code by line-of-code
basis to find errors. For inspections and walkthroughs, SQA
assures, at a minimum, that the process is properly
completed and that needed follow-up is done. The inspection
process may be used to measure compliance to standards.

3. Formal Test Monitoring

SQA assures that formal software testing, such as acceptance
testing, is done in accordance with plans and procedures.
SQA reviews testing documentation for completeness and
adherence to standards. The documentation review includes
test plans, test specifications, test procedures, and test
reports. SQA monitors testing and provides follow-up on
nonconformances. By test monitoring, SQA assures software
completeness and readiness for delivery.

The objectives of SQA in monitoring formal software testing
are to assure that:

The test procedures are testing the software
requirements in accordance with test plans.

The test procedures are verifiable.

The correct or "advertised" version of the software is
being tested (by SQA monitoring of the CM activity).

The test procedures are followed.

Nonconformances occurring during testing (that is, any
incident not expected in the test procedures) are noted
and recorded.

Test reports are accurate and complete.

Regression testing is conducted to assure
nonconformances have been corrected.

Resolution of all nonconformances takes place prior to
delivery.

Software testing verifies that the software meets its
requirements. The quality of testing is assured by
verifying that project requirements are satisfied and that
the testing process is in accordance with the test plans and
procedures.

E. Software Quality Assurance During the Software Acquisition Life Cycle

In addition to the general activities described in
subsections C and D, there are phase-specific SQA activities
that should be conducted during the Software Acquisition
Life Cycle. At the conclusion of each phase, SQA
concurrence is a key element in the management decision to
initiate the following life cycle phase. Suggested
activities for each phase are described below.

1. Software Concept and Initiation Phase

SQA should be involved in both writing and reviewing the
Management Plan in order to assure that the processes,
procedures, and standards identified in the plan are
appropriate, clear, specific, and auditable. During this
phase, SQA also provides the QA section of the Management
Plan.

2. Software Requirements Phase

During the software requirements phase, SQA assures that
software requirements are complete, testable, and properly
expressed as functional, performance, and interface
requirements.

3. Software Architectural (Preliminary) Design Phase

SQA activities during the architectural (preliminary) design
phase include:

Assuring adherence to approved design standards as
designated in the Management Plan.

Assuring all software requirements are allocated to
software components.

Assuring that a testing verification matrix exists and
is kept up to date.

Assuring the Interface Control Documents are in
agreement with the standard in form and content.

Reviewing PDR documentation and assuring that all
action items are resolved.

Assuring the approved design is placed under
configuration management.

4. Software Detailed Design Phase

SQA activities during the detailed design phase include:

Assuring that approved design standards are followed.

Assuring that allocated modules are included in the
detailed design.

Assuring that results of design inspections are
included in the design.

Reviewing CDR documentation and assuring that all
action items are resolved.

5. Software Implementation Phase

SQA activities during the implementation phase include the
audit of:

Results of coding and design activities including the
schedule contained in the Software Development Plan.

Status of all deliverable items.

Configuration management activities and the software
development library.

Nonconformance reporting and corrective action system.

6. Software Integration and Test Phase

SQA activities during the integration and test phase
include:

Assuring readiness for testing of all deliverable
items.

Assuring that all tests are run according to test plans
and procedures and that any nonconformances are reported
and resolved.

Assuring that test reports are complete and correct.

Certifying that testing is complete and software and
documentation are ready for delivery.

Participating in the Test Readiness Review and assuring
all action items are completed.

7. Software Acceptance and Delivery Phase

As a minimum, SQA activities during the software acceptance
and delivery phase include assuring the performance of a
final configuration audit to demonstrate that all
deliverable items are ready for delivery.

8. Software Sustaining Engineering and Operations Phase

During this phase, there will be mini-development cycles to
enhance or correct the software. During these development
cycles, SQA conducts the appropriate phase-specific
activities described above.


F. Techniques and Tools

SQA should evaluate its needs for assurance tools versus
those available off-the-shelf for applicability to the
specific project, and must develop the others it requires.
Useful tools might include audit and inspection checklists
and automatic code standards analyzers.


source: http://jira.atlassian.com

 
Creative Commons License
This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 License.