Skip to content

Bug | Mismatch between optional parameters in the proto definitions and the Python API #103

@sabarinathan-ni

Description

@sabarinathan-ni

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

  1. In python documentation, the * can be moved after the list of required arguments.
  2. Documentation can be updated to explicitly indicate the optional parameters as in the below image.
Image

AB#3744858

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions