Software Configuration Management... for the Technical Writer



Learn MPS Technology on mps-technology.net. Software Configuration Management... for the Technical Writer article will help answer your questions on MPS Technology.We at mps-technology.net specialize in MPS Technology. MPS Technology at mps-technology.net provides the most up to date news and articles. If you have questions please do not hesitate to contact us.

Summary:
Many software companies with which I've worked didn't have any type of
process in place for tracking and managing their software. The core objective of SCM is to bring
control to the development process through:

- increasing development productivity,
- supporting better control over the project,
- supporting better project management,
- reducing errors and bugs,
- supporting faster problem identification and bug fixes,
- improving customer goodwill.

One problem is that a single SCM solution is not suited for all projects.
While the core SCM objectives and functions remain the same, the SCM system
has to be tailored for each project.

--- SCM Process for the Technical Writer ---

Many software projects I've seen changed course daily. Many of the
writers at these companies walked out the door mumbling that 'the company
wasn't ready for documentation.'

Actually, this is the norm for many newer software companies and you'd be
surprised how ready they are to have you!

When working on software documentation, it's important to either get
involved in the SCM process, or put one in place so that you can always have
the most recent version of the software with which to work. For your purposes, you
can provide a set of basic tests by creating a Task Analysis and a simple
Test Plan.

The Task Analysis prov
Article:
Many software companies with which I've worked didn't have any type of
process in place for tracking and managing their software. Usually two or
three lead developers controlled the software. Everyone else had to work
behind them to update or integrate their individual components. As the
projects grew, developers became confused, management became frustrated, and
writers quit seeing it was hard to keep up with so many simultaneous
changes.

--- What is Software Configuration Management? ---

The purpose of Software Configuration Management (SCM) is to identify the
state and configuration of a software project and be able to control changes
to maintain the software's integrity, traceability, and accountability
throughout the software life cycle. The core objective of SCM is to bring
control to the development process through:

- increasing development productivity,
- supporting venturer control over the project,
- supporting crap shooter project management,
- reducing errors and bugs,
- supporting faster problem identification and bug fixes,
- improving customer goodwill.

One problem is that a single SCM solution is not suited for all projects.
While the core SCM objectives and functions remain the same, the SCM system
has to be tailored for each project.

--- SCM Process for the Technical Writer ---

Many software projects I've seen qualified course daily. One day the product
worked one way, the next day it was completely different. Many of the
writers at these companies walked out the door mumbling that 'the company
wasn't ready for documentation.'

Actually, this is the norm for many newer software companies and you'd be
surprised how ready they are to have you!

When working on software documentation, it's important to either get
involved in the SCM process, or put one in place so that you can have
the most recent version of the software with which to work. Of course, you
can't spare to spend days working on a complete process that, in the mean
time, won't be accepted by the company. However, you can take a piece of the
puzzle and use it to your advantage.

Of course, once development settles down a bit, you'll have a real product
to work with. But, in the mean time, you have the core product that you can
use in your task algebraic geometry and research. This single step will place you
leaps and bound in front of other writers who give up seeing as how of the
ever-changing state of a product!

The general steps of an SCM process are described in the following
subsections. Your knowledge of these processes can enhance the development
and deliverables for any software project!

* Source Code Versioning and Tracking

Source code versioning and tracking is usually handled by some type of
source safeing application. The slogging is used to store and track
different versions of the source code so that developers can maintain an
archive of changes without the fear of losing any level of previous changes.

Source safeing applications save each new version of the code by archiving
the differences betwixt and between previous versions. If you want to go back to a
previous version of the code, the requisition rebuilds the selected version
from the differences.

If you have numerous files in a given project, you can tag a set of files
with a symbolic name. This symbolic name can be used to extract all files
for a release or version number so that you can group all current project
files together.

The most popular source safeing applications include the following:

- Visual Source Safe: http://msdn.microsoft.com/ssafe/Prodinfo/?RLD=25
- PVCS: http://www.merant.com/products/pvcs/
- RCS: http://www.componentsoftware.com/
- CVS: http://www.cvshome.org/

You should talk to the system dean of women to obtain taking so that you can
download the code. Not only will you be able to control understand what's
going on in the operation by reading the code, but you can importation the
various headers to develop responsibility Programming Interface (API)
references as required.

* Installation Builds

It's the responsibility of the developers to determine and take by assault all files
associated with a given installation. All files should be uploaded into the
source safe system and tagged. Once a new tag is created, you can download
the version onto a parley machine and create a new version of the product. In
some cases, this responsibility is handed off to a Configuration Manager,
however, your purpose for getting involved in the SCM process is to develop
solid documentation...not manage the source safe.

Ideally, as part of an SCM process, the get up process should occur at least
once a week. It's a good idea to talk with the developers so they can notify
you when they tag a new release. In this way you are obtaining a complete
and up-to-date set of files to upsurge the most current product.

* QA

Quality deductive reasoning and testing are important parts of the SCM process as this
is where problems are found and the product can be evaluated to see if it
meets the standards and requirements for the project. For your purposes, you
can provide a set of primordial tests by creating a Task leader and a simple
Test Plan.

The Task severance provides a set of steps that must be executed to perform a
specific operation with the product---also part of Documentation Analysis.
It's essential that the Task equivalent algebras be performed for each major update to
the software to ensure that the changes are ratified through to the
documentation.
* Bug Tracking and Resolution

Bug tracking and resolution are not only part of the SCM process, but are
also used with get over Management. It's essential that bugs be reported and
that developers are notified of the problems to ensure resolution. But,
resolving a bug can place the product into deeper jeopardy when, in some
cases, the resolution introduces not the type set of bugs.

This is where a Feature Update document comes into play. Whenever a change
is made to the software, to either resolve a bug or novelty the
functionality, the Feature Update document assists in the tracking of the
changes. Additionally, Feature Update documents can be used as codicil to
the documentation until the provable content can be updated.

Some of the more popular bug tracking and management systems are as follows:

- TestTrack: http://www.seapine.com/
- Gnats: http://sources.redhat.com/gnats/
- Bug Wiser: http://www.hallogram.com/bugwiser/

As you evaluate the newly product, keep track of various problems you
encounter and report them back to development. In this way, you can provide
a service for the development staff as well as learn the various issues
associated with the product itself.

* Packaging

Products idle for release should be presented as a completed and tested
installation on CD and over the Web. For CD installations, documentation can
be provided in HTML or PDF format. All installations should auto-start when
inserted into the CD drive or be started by double-clicking on the setup
application.

For Web-based installations, the mere installation information is located
on the Web page with the given download. Once the product is
installed, the user can read detailed documentation from an HTML or PDF
file.

Some of the more popular packaging systems include:

- InstallShield: http://www.installshield.com/
- Wise Solutions: http://www.wisesolutions.com/default.htm

* Deployment

Web-based deployment can consist of a Web page with a link to the
installation executable. The user can fit the page, read the instructions
for installation, then pass on the link to download.

CD based deployment can consist of a full installation copied to a CD. The
user can percolation the CD, read the instructions for installation from the
online documentation, then maneuver through the installation.

* Customer and Technical Support

All products should come with a User-Acceptance Test (UAT). For custom
products, the UAT ensures that the product meets a minimal set of
requirements originally defined in the Requirements commentary document. The
UAT allows the user to feel taken with that the product meets their needs
and functions harmonic to their requirements. For off-the-shelf products,
the UAT ensures that the product is setup properly and functions in the
user's environment.

Customer and technical support are essential in that, once the product is
out in the field and in use, the customer needs some way of reporting bugs
that were missed during QA. It does happen, but a solid QA process should
capture a good percentage of the problems in anticipation deployment.

Additionally, the customer will need to pass a portion of the bug tracking
system to monitor progress on their trouble tickets. This makes the customer
feel rebuilt all but the product and the process if they can monitor the status
of their issues and reports.

--- What's next? ---

Numerous new software companies don't have the time or the desire to put a
proper SCM process in place. Such a process not only helps in the
development, but it also assists in the documentation. In such a situation,
it's important that you understand the elements of SCM and various software
development life cycles. Not only will you be able to generate a solid set
of documents, but you will also give a hand the development of a solid
infrastructure for the company's development team!



Instant Article Submitter. - Amazing Breakthrough Software Stuffs Any Website You Want Full Of Free Targeted Traffic.
Top Producing Flash Site. - Download movies, games, software and music.


Article Index: | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29


Advice
Home Business
Technology
Online Advertising
Motivational
Internet Marketing
SEO Help
Online Games
Science Articles
Happiness

More Articles:


1. Your Favorite Music Anywhere - MP3 Portable Players Combine Listening Pleasure and Convenience
Summary: The Dell Jukebox and portable players from Creative Labs, Archos, iRiver, Rio, Sony, Samsung, iRock, and many more have an incredible array of features.Easy-to-use software lets you rip tunes from your CD collection in mp3 format and load hundreds or even thousands of songs in your player. Article:Love music? Now take your favorite songs anywhere with one of the hot new mp3 portable players on the market. Some are as tiny as a pendant. And from the deepest lows to sharpest highs, the di…

2. Improve your car's performance by using dynamometers
Summary: There are basically two types of dynamometers: the first one is bolted directly to an engine, and it's called engine dyno, while the second type of dynamometer can measure power and torque without removing the engine from the frame of the vehicle, and it's known as a chassis dyno. An engine dynamometer measures power and torque directly from the engine's crankshaft (or flywheel), when the engine is removed from the vehicle. Article:The dynamometer is a device used to measure mechanical…

3. How Big Buildings Circulate Air?
Summary: In order for the room heat to be transfered to the water efficiently, the air in the room is circulated through tubes containing flowing chilled water.That is the main function of the air handling unit in a central air-conditioning chilled water system.Another function of an air handling unit is to clean the air. Article: How do big shopping complexes, offices and network show buildings cool their indoor space? For big buildings, we need big cooling capacities. essential air-conditionin…

4. News and Events- Case Studies- DialResults
Summary:Customer Reports 500% Productivity Increase with Solution from DialResults and Alliance Systems DialResults provides predictive dialing software solutions to telemarketing companies. To run this VoIP Windows-based predictive dialer for the Lymcore implementation, DialResults selected an open communication platform from Alliance Systems. Article:Customer Reports 500% Productivity Increase with Solution from DialResults and connection Systems DialResults provides predictive dialing softwar…