Discussion Questions

Discuss how you might use hypertext or a Web-based documentation suite to provide a custom package for each kind of architectural stakeholder.

Discuss the advantages and disadvantages of various packaging schemes: a single large document, a small number of separate documents, and a separate document for each kind of information. For a project you have in mind, which would you choose, and why? Make sure to consider configuration management concerns and stakeholder needs in your discussion. What other criteria would help you decide?

This chapter has prescribedor at least allowedcertain kinds of information that might also exist in the overall project documentation: glossary of terms, list of acronyms, and system overview. Make a case for the architecture documentation package including its own version of these things, separate from the overall project set.

Imagine the sample documentation given in Appendix A was online. Mark all the places where hypertext links would make using the documentation easier.