I feel it will be better to provide a sperate section for design decisions. Having a seperate section will allow you to provide rationale along with the different options considered before arriving at the final decision
posted 6 years ago
Assumptions and design decisions are separate sections.
Try to provide cross references in the main html file so that evaluator won't get lost while going thru the assignment.