H.2.2 API Discovery

Reading progress2 helpful
Article in preparation — showing conspect notes

Finding code is not the same as finding the supported way to use it.

  • Curated API documentation states the supported contract; implementations reveal mechanics but may expose private behavior.
  • Representative consumers and examples show real conventions, composition, and edge cases.
  • Surface compatibility posture, deprecation state, support status, and contribution guidance beside the API.
  • Treat a popular private implementation path as accidental coupling, not an automatically supported interface.