clarify documentation of the /suggest endpoint

- Reorganizes the documentation to be clearer about what parameters are required for the /suggest endpoint
- Adds a note that the "max" parameter exists, and that it has a default.