1. API Documentation intermediate

    A team generates its entire API reference from code annotations and deletes the hand-written guide. Six months later integrators are opening more support tickets, not fewer, and every one of them is technically answerable from the reference. What did generation buy, and what did it destroy?

    2 min answer hugging faceapi documentationdeveloper experiencedrift
  2. API Documentation intermediate

    A workspace platform's API is well designed but developers repeatedly build integrations that break under real conditions. What is missing from the documentation, and what should be added?

    2 min answer api-documentationdeveloper-experiencesemanticsnotion
  3. API Documentation intermediate

    Why is documenting an API's failure and retry semantics more important than documenting its success behaviour?

    2 min answer documentationstripeidempotencydeveloper-experience
  4. API Documentation intermediate

    Your platform has 60 internal APIs. Teams repeatedly rebuild capabilities that already exist because they cannot find or understand them. What do you build?

    2 min answer documentationdeveloper-portaldiscoveryspec-first
  5. API & Integration intermediate Multiple choice

    You are designing APIs for a platform with a web app, a mobile app, internal service-to-service traffic and third-party partners. What do you expose, and where?

    2 min answer restgraphqlgrpcapi-design
  6. APIs as Products intermediate

    A platform's API is used more heavily than its web interface, and third-party tools built on it drive most adoption. What changes when the API is treated as the primary product rather than as an access mechanism?

    2 min answer api-productdeveloper-experienceversioningecosystem
  7. APIs as Products intermediate Multiple choice

    How do you know it is safe to remove a field from a public API, and what would you have needed to build to know that?

    2 min answer deprecationinstrumentationgithubapi-lifecycle
  8. API Versioning intermediate

    Your mobile app's API has 14 versions in the field, the oldest three years old. Product wants to remove support. How do you decide?

    2 min answer mobileversioningdeprecation
  9. Partner & B2B Integration intermediate

    Partner integrations take four months from contract signature to production traffic. Engineering says the work is three days. Where does the time go and how do you cut it?

    2 min answer b2bonboardingdeveloper-experiencesandbox
  10. Backward Compatibility intermediate

    What happens if an enterprise software vendor adds a required field to a widely-integrated interface, believing it is a minor change?

    2 min answer backward-compatibilitybreaking-changeintegrationenterprise
  11. Contract Testing intermediate

    A platform has many services and many external consumers. Integration tests are slow and flaky. What testing strategy actually gives confidence about compatibility?

    2 min answer hasuracontract-testingconsumer-drivenci
  12. Contract Testing intermediate Multiple choice

    Before deploying, how do you know whether removing a response field will break any consumer?

    2 min answer contract-testingconsumer-drivencispotify