Document how documentation is to be interpreted
Problem
The autogenerated documentation is not immediately clear to user how are new to grpc/proto. For example, here, when you use a javascript object of the MultitransactionRequest, what (getter) functions can I expect. When do fields contain the given Types and when an array?
Solution
- Explain top level (here?) briefly what is done and why? (We use GRPC as a remote procedure call to provide an alternative to REST API and use proto to auto generate client code....)
- Provide a link to the generic grpc/proto documentation.
- Give a few hints (2-3 sentences) how documentation can be interpreted and provide link to the appropriate grpc/proto documentation that explains it in detail