Oct 242014

connectorSoloDocumenting interfaces has always been a challenge. We put the interface requirements in a separate document and give that as a part of the documentation to the groups designing on both sides of the interface. Now I have a single document with all aspects of the interface neatly covered, but when I look at my system requirements, I am missing some aspects that are hidden away in various interface specifications. It would be nice to have all my environmental requirements in one place, all my physical requirements in one place and so on. For complicated interfaces, perhaps a separate document is a good idea, but for simple interfaces, I think there is a better way. Continue reading »

Aug 282014

brainShiftI had one of those brain shifting conversations today, you know the type, where an obvious assumption of mine was totally different from the obvious assumption of the person I was speaking to.

This is another post about the IBM Rational DOORS Next Generation with Configuration Management Beta software, for more information go to jazz.net where the beta is available to try, and the development is being managed in a publicly visible Rational Team Concert database.

I had assumed that every engineer, or analyst working in DOORS Next Generation with Configuration Management, would have their own workspace and deliver changes to a parent workspace managed by an integration engineer of some description. Continue reading »

Jul 232014

A little while ago, I posted about Real Configuration Management for Requirements, but I didn’t go in to any detail about HOW it should, or could be used.  Requirements engineers/managers are not typically working with configuration management at this level on a daily basis, so I have set out a very basic flow here. First of all, you need to know that this post describes working with an open Beta release of DOORS Next Generation, and all manner of changes can occur before this functionality is ever released.

I set up an empty project as described in my previous post to work through the basic exercise shown in the image here.  One Variant, with one Version, and two Engineers working on the problem. I thought it best to start simple and find out how this might actually work for real. If I lose you in the description then come back to this diagram for reference.

2014-07-23 11.36.50-1

Continue reading »

Jul 042014

DOORSPartitionProcessI posted a while ago on using DOORS Partitions for offline working. In that post, I mentioned that we had worked out a process for managing the data in a supply chain, and that is what I am going to cover here.

In an ideal world, you would have your suppliers directly accessing your data on your server through a secure hole in your firewall. In practice this seems to be a very rare occurrence. Even where I have seen access granted, it has been on a separate LAN so that you plug in to a red CAT5 cable to access the customer network. Web based tools are pointed to as a silver bullet for collaboration, but in fact there is no difference between allowing someone from outside your organization to access a secure web based tool with a browser, or allowing them access through a DOORS thick client to your database. This problem is not one of technology, but one of security and people. Continue reading »

Jun 272014

P1010692DOORS Next Generation is getting Configuration Management capabilities. This is a huge step for DOORS NG, a requirements management tool. The CM capability is similar to what you might expect for source control, with similar language, like ‘streams’, ‘deliver’, ‘workspace’, and others. I think that we will find that many requirements management users (or Business Analysts) who are unfamiliar with the concepts and terms, and there will be much confusion to resolve. However, the capability will be very much welcomed by the user community who are looking for stronger governance over their Requirements Management process. Continue reading »

Mar 262014
Documenting a DOORS Database Schema

Following on from the Information Architecture Workshop series, I want to show an example of how some of that information should be documented. A comprehensive document should be made available, but also a summary document for quick reference and guidance. Some years ago we produced a quick reference document for a generic schema and process, […]