Clean up issues with api/discussions.md
The following discussion from !51032 (merged) should be addressed:
Items for doc/api/discussions.md
identified by @tommd need to be addressed by this follow-up, assigned to an engineer:
- Add a curl example for:
-
single-line comments -
multi-line comments
-
-
Document how to post single line comments. -
Document how to construct a linecode - hash of the file name (path included) underscore old line number (is this needed? Some tools don't even know the old number), underscore and the new line number. -
Document the bug where incorrect SHAs result in HTTP 500 but still posts a comment with the "download" button which I pictured in the original issue. #281143 (closed) #296829 (closed)
Edited by Matt Nohr