Reputation: 11042
The first three chapters in arc42 are related to software requirements:
Most projects start with a detailed specification (hopefully) already containing all requirements.
Now my questions (which are - I guess - mainly best practice questions)
Should I copy the requirements which are relevant for the architecture in case that people only read the architecture documentation?
Or are those requirements for the template different to the main project requirements?
Upvotes: 3
Views: 754
Reputation: 11042
Since I now had enough time to think about my own question, I will now try to answer it myself:
When you face business driven project, the requirements found in the specification will differ from the requirements which drive your architecture. So you will have to analyze the requirements and extract requirements for your architecture - these are most likely new one and it might make sense to take a note which business requirements where the driver for your architecture requirements.
Example: The business requirements state that your app has to produce three different reports. These requirements will describe the reports in detail, but those details do not matter much regarding the architecture. But the fact that you may need a reporting module with the right capabilities might be the right requirement for your architecture. And that's what should be written down in your arc42 documentation.
Upvotes: 4