How to document other party's APIs?
I am having a hard time finding any good tools to document APIs that are not my own. Swagger et al. are all built around documenting your own APIs, but a there are a ton of undocumented or insufficiently documented APIs out there for which one needs to create documentation so that developers can work with them.
Does anyone know any tools out there that can do this and are not called Google Docs? I need to be able to paste XML and JSON bodies and annotate individual lines, parameters, etc. in the margin.
I'd look into a KnowledgeBase type product that fits your needs. Might want to checkout: https://www.gitbook.com/ or https://www.archbee.io/.
Haven't used either so not a rec or an endorsement, just what I have on my list!