Activity 23Greatest Hits Reading List

As a software system grows, so does the documentation that describes its architecture. A greatest hits reading list will help stakeholders navigate the morass of design artifacts so they can find relevant information. Creating a curated reading list provides new stakeholders with a starting point for learning about the architecture.

Benefits

  • Highlight the most important design artifacts.
  • Provide context for design artifacts within the scope of the whole system.
  • Unify disparate, lightweight design artifacts to create a coherent, whole description.

Description

The greatest hits reading list is often a simple link page on the team’s wiki. Each link should include the following information:

Title

A brief, descriptive ...

Get Design It! 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.