An overview of creating Autodiscovery scans
You can only suggest edits to Markdown body content, but not to the API spec.