I hate documenting http endpoints using golang comments so here's an alternative using annotations inside your protobuf files which I think is a superior way of managing your API contracts
This is just a very simple(hopefully easy to digest) working example