How can consistency of document design be implemented

Documents become inconsistent for many reasons:

• The UI prototyper misunderstood the functional requirements and so the user interface doesn't really behave in the way that will achieve the required functionality.
  
• The developer creating the design discovered some omissions or unclarities in the specification or prototype but didn't tell anyone and just fixed it in the design. So now the design document is different thant the specification.
  
• During implementation a developer may have found that part of the detailed design was missing or incorrect, so they just wrote the code without the necesssary pseudocode.
• Perhaps as your design evolved, you deviated (perhaps unwittingly) from the original requirements without recording it in the specification.
• Frequently people discover during design that they are resolving some issue that is really a requirements issue, but they don't update the specification.
• The analyst added a new requirement but the traceability matrix didn't get updated.
  
• During detailed design review, teams realize that they forgot to include some customer requirements in their design.
• If a team gets behind schedule in the crunch of trying to get the implementation completed programmers ignore the design and just hastily throw together anything they can get to work. The result is an implementation that is different than the design.
  

• The specification needs to match the high level design.
• The detailed design needs to match the class headers,
• The Stage 1 implementation needs to match the design (and the specification).
• The traceability matrix needs to match the specification.
• The implementation plan needs to match the design.
  
• The implementation needs to match the prototype.
• The test cases need to match the specification.

You don't need to update those portions of the User Interface Prototype which have been superceded by the implementation. However, any significant changes should have gone through the Change Control process. Those UI screens which are now obsolete should be annotated with the Change Request number for the corresponding modification.

Be sure to update the document history for any documents to which you make changes.

The instructor will check for document consistency at random times throughout the project. For example, the instructor will pick a requirement from your staged delivery plan and ask you to show where it appears in the traceability matrix and that the design diagram is consistent with the javadocs and the pseudocode.

Document History