We take the “bare minimum” approach in Figma, and focus on our users' common questions:
- When should I use this component?
- When should I use something else?
- What are the best practices for this component?
From there we link out to external documentation, which covers more granular guidance.