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.


    EDIT: Removed inaccurate statement about previous docs.

  2. Log in to comment