All the parameters in the python API documentation are marked optional whereas the proto file documentation clearly distinguishes between required and optional parameters.
Example: The API documentation for the TestResult object does not clearly state that the Name parameter is required and the other parameters are optional. This is clearly defined in the proto file.
Suggestions
- In python documentation, the
* can be moved after the list of required arguments.
- Documentation can be updated to explicitly indicate the optional parameters as in the below image.
AB#3744858