React

React’s docs use per-API “Caveats” callouts as the known-issues surface. The useEffect caveats list is the canonical example — a long, specific enumeration of behaviors that surprise developers, with the official line on each.

This pattern of attaching known-issues to individual APIs rather than collecting them in a separate file works well for a library where most issues are API-specific. Worth bookmarking the caveats for any hook you use heavily.