Revise Commands documentation to not be CLI-centered

[hsanjuan]

Version information: next

Type: Enhancement

Priority: P5

Description:

This is a note for something that I should eventually revise. Since we now autogenerate documentation directly from the code (https://github.com/ipfs/ipfs-http-api-docs), we should aim to have Commands documentation provide descriptions which serve for both CLI and HTTP API (which are the same thing at the end). Of course, the CLI user should find them as useful as before.

This applies only to the things that are used for the auto-generation:

• Helptext.Tagline
• Arguments.Description
• Options.Description

The CLI-centered descriptions are a minority so this is a minor issue anyway.

[whyrusleeping]

Hrm... unsure about this. We often put example cli command invocations in the helptext, thats hard to have apply to both HTTP and CLI