Document the "suggest" API method

Per statedecoded/statedecoded#444.