What are the rules of a sound architectural documentation?

 Posted by Niladri.Biswas on 10/1/2012 | Category: Design Pattern & Practices Interview questions | Views: 1212 | Points: 40

- Rationale behind key points

- Consider the reader’s point of view

- Avoid unnecessary repetition

- Avoid ambiguity

- Focus on the problem in hand than the technology

- Use standards

- Other NFRs such as cost

- Record rationale behind the document

- Keep documentation current, but not too current

- Concise References – if already existing on the web

- Use Links

- Review documentation for fitness of purpose

Asked In: Many Interviews | Alert Moderator 

Comments or Responses

Login to post response