Breaking News: Grepper is joining You.com. Read the official announcement!
Check it out

Documenting Our API

Sumit Rawal answered on May 24, 2023 Popularity 5/10 Helpfulness 1/10

Contents


More Related Answers

  • what to consider when writing api document
  • what to write in api document
  • The API operation is documented
  • Modifying the API specification
  • Other APIs

  • Documenting Our API

    0

    An overview of why documentation is important, existing approaches to it, and the one we will be using.

    We'll cover the following

    Do we need documentation?

    The lay of the land

    Do we need documentation?

    We have to tackle one missing point: We have to document our API.

    But isn’t the code documentation enough?

    No, it is not! Leaving the issues of properly documented code aside, we will concentrate on documenting the API.

    The de facto standard in our days seems to be using Swagger for this. To keep things simple, we will stick to it. Besides that, it won’t hurt to have some documentation in text form (a small file could be enough), which should explain the quirks of our API. The bigger the project, the earlier you may encounter flaws in the logic, which might not be changeable because of whatever reasons.

    Popularity 5/10 Helpfulness 1/10 Language whatever
    Source: Grepper
    Tags: api whatever
    Link to this answer
    Share Copy Link
    Contributed on May 24 2023
    Sumit Rawal
    0 Answers  Avg Quality 2/10


    X

    Continue with Google

    By continuing, I agree that I have read and agree to Greppers's Terms of Service and Privacy Policy.
    X
    Grepper Account Login Required

    Oops, You will need to install Grepper and log-in to perform this action.