💎 Documentation
Overview¶
The add_docs
tool scans the PR code changes, and automatically suggests documentation for any code components that changed in the PR (functions, classes, etc.).
It can be invoked manually by commenting on any PR:
Example usage¶
Invoke the tool manually by commenting /add_docs
on any PR:
The tool will generate documentation for all the components that changed in the PR:
You can state a name of a specific component in the PR to get documentation only for that component:
Configuration options¶
docs_style
: The exact style of the documentation (for python docstring). you can choose between:google
,numpy
,sphinx
,restructuredtext
,plain
. Default issphinx
.extra_instructions
: Optional extra instructions to the tool. For example: "focus on the changes in the file X. Ignore change in ...".
Notes
- Language that are currently fully supported: Python, Java, C++, JavaScript, TypeScript, C#.
- This tool can also be triggered interactively by using the
analyze
tool.