Files
pr-agent/docs/ADD_DOCUMENTATION.md

25 lines
1.2 KiB
Markdown
Raw Normal View History

2023-12-24 13:08:13 +02:00
# Add Documentation Tool 💎
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.).
2023-10-01 19:51:15 +03:00
It can be invoked manually by commenting on any PR:
```
/add_docs
```
For example:
2023-10-02 10:11:28 +03:00
2023-12-24 13:08:13 +02:00
<kbd><img src=https://codium.ai/images/pr_agent/docs_command.png width="768"></kbd>
___
<kbd><img src=https://codium.ai/images/pr_agent/docs_components.png width="768"></kbd>
___
<kbd><img src=https://codium.ai/images/pr_agent/docs_single_component.png width="768"></kbd>
2023-10-01 19:51:15 +03:00
### Configuration options
- `docs_style`: The exact style of the documentation (for python docstring). you can choose between: `google`, `numpy`, `sphinx`, `restructuredtext`, `plain`. Default is `sphinx`.
2023-12-24 13:08:13 +02:00
- `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.
- For languages that are not fully supported, the tool will suggest documentation only for new components in the PR.
- A previous version of the tool, that offered support only for new components, was deprecated.