Where necessary use sub-sections to structure the "Recommended markup" section

[simonsinclair]

For Promo's the "Recommended markup" section leads with information on Promo containers, not Promos. This is important, however:

To implement a Promo in React or other popular library we would need to build the Promo and then, as suggested, a way of holding one or multiple. My suggestion is not to remove any information, but to structure it more in component-driven way.

Clearer sub-sections and titles would help a reader navigate. For example:

• Recommended markup
  • Container
    • Multiple promos
  • Promo