docs: move code samples to request examples, fix descriptions:

[jstirnaman]

• Move examples out of text and curl shell examples to request body examples. The interesting bits are in the data, not the command. Rapidoc will display the payload schema as well as examples we define, though Redoc doesn't for now.
• Style cleanup.
• Improve descriptions.

Split out of #574.