New API v2 Documentation is Horrendous

Issue #13063 open
Dillon
created an issue

The new documentation that was previously rolled out is absolutely horrible. It's navigation is confusing, there is a ton of missing descriptions, and the response bodies don't exist for some endpoints, commits for example.

You guys had a functional API document and, for some reason, you pushed into production a significantly worse version of it. Please consider revert those changes or, at the very least, finishing the current implementation. Using the the web archive is a crappy work around just to read documentation on your API...

Comments (3)

  1. Alastair Wilkes staff
    • changed status to open

    Hi Dillon,

    Thanks for your feedback and for developing against the API. We'll review the gaps and close them where possible.

    Apologies for the inconvenience.

    Alastair

    EDIT: Removed inaccurate statement about previous docs.

  2. Log in to comment