I suggest you ...

Generate documentation info from JSON Schema

When JSON schema is provided, inject documentation (in form of table?) into related resource.

41 votes
Vote
Sign in
Check!
(thinking…)
Reset
or sign in with
  • facebook
  • google
    Password icon
    I agree to the terms of service
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    Lukas LinhartLukas Linhart shared this idea  ·   ·  Admin →

    7 comments

    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)
      Submitting...
      • Lukas LinhartAdminLukas Linhart (Admin, apiary.io) commented  · 

        Hi Olivier,

        MSON was released just few days ago—and we are now actively working on the way the informations are represented.

        Regards,

        Lukas

      • Lukas LinhartAdminLukas Linhart (Admin, apiary.io) commented  · 

        Hi,

        we are working on better way of writing schemas (called MSON). We are going to extract descriptions from it, but I can't yet tell whether Schema is going to be supported together with it as well.

        Regards,

        Lukas

      • schmeelschmeel commented  · 

        Any update? I'd like to know if I should continue investing time in extensive manual documentation of request/response properties, or if I can focus on populating descriptive json-schemas and count on Apiary generating nice documentation from that in the near future.

      • Wissam TabbaraWissam Tabbara commented  · 

        any progress on this? this is very basic functionality.

      • AnonymousAnonymous commented  · 

        I'm pretty surprised that this isn't supported yet. Any progress on this?

      Feedback and Knowledge Base