Research improved HTTP API presentation

[jessicaschilling]

Research the best ways to present API reference material, keeping in mind:

• Searchability
• Ability to direct-link to specific calls (for use in, for example, replies in forum posts)
• Showing only the relevant information at the right time (i.e. judiciously applied expand/collapse that doesn't break search)

Implementation of this issue lives under #225.

[jessicaschilling]

Original notes from issue #225, circa Aug 2019:

IPFS HTTP API section is hard to search and parse. The HTTP API section is currently a long list of CLI commands that one has to endlessly scroll through. It is hard to scan and quickly search for a command and argument.

When we choose our future framework, we should find a platform that will help us organize our APIs in a more user friendly fashion (i.e. includes great search).

We can alternatively use Swagger for our API Docs.

[jessicaschilling]

Also see #225 (comment) for further thoughts.

[jessicaschilling]

Also see #69 for additional background.

[jessicaschilling]

Closing, since this issue has been consolidated into the overall effort for improving/automating API/CLI documentation in #393. Comments have been migrated there!