Appendix B. Making the Models into Documents

B.1. Organizing the Models

When you have completed the requirements and architecture models, and assuming they are not just for your own or your immediate group’s consumption, you probably will be faced with the issue of how to transform this stack of diagrams and specifications into presentable documents. In many cases, they will be deliverable items to your customers, and may have to fit into their or your standard document formats. If your customer is a government agency, you will have to conform with whichever government standard documentation specification is imposed by your contract.

The problem is, all these formats and standards were designed to provide structure where none existed—to give ...

Get Strategies for Real-Time System Specification now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.