We are using Stoplight to create an external (and internal) documentation of our services APIs.
We also provide a JS SDK wrapping some of the API functionality for the use of JS Developers.
I can see several options:
- Add the relevant SDK methods descriptions on each of the API methods pages
- Add it as separate pages - either as MD or HTML pages, or as part of the hub pages.
I prefer to use the format used in the hub pages, but then I cannot share the same page with multiple hubs (e.g. for sharing content between internal and external hubs)
Any suggestions ?