[sersi]

> It might be that with precision, readability is lost

The poster you replied to just wrote a comment on HN that is meant to be read by an audience, is clear, well written and well structured. Given that, why ever would you assume that the documentation that same poster produced would be too terse to serve the job?

[rayiner]

Ding ding ding, correct answer! OP's target audience was people who are supposed to be using an API endpoint. It's self-evident OP can write clearly enough to communicate with the target audience.