chore: add info on reStructuredText to contributing guidelines for release notes (#10064)

* chore: add info on reStructuredText to contributing guidelines for release notes

* refine
This commit is contained in:
Stefano Fiorucci 2025-11-12 13:13:38 +01:00 committed by GitHub
parent b30c6d9700
commit 6cbd1857d1
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 23 additions and 5 deletions

View File

@ -17,9 +17,10 @@
### Checklist
- I have read the [contributors guidelines](https://github.com/deepset-ai/haystack/blob/main/CONTRIBUTING.md) and the [code of conduct](https://github.com/deepset-ai/haystack/blob/main/code_of_conduct.txt)
- I have updated the related issue with new insights and changes
- I added unit tests and updated the docstrings
- I have read the [contributors guidelines](https://github.com/deepset-ai/haystack/blob/main/CONTRIBUTING.md) and the [code of conduct](https://github.com/deepset-ai/haystack/blob/main/code_of_conduct.txt).
- I have updated the related issue with new insights and changes.
- I have added unit tests and updated the docstrings.
- I've used one of the [conventional commit types](https://www.conventionalcommits.org/en/v1.0.0/) for my PR title: `fix:`, `feat:`, `build:`, `chore:`, `ci:`, `docs:`, `style:`, `refactor:`, `perf:`, `test:` and added `!` in case the PR includes breaking changes.
- I documented my code
- I ran [pre-commit hooks](https://github.com/deepset-ai/haystack/blob/main/CONTRIBUTING.md#installation) and fixed any issue
- I have documented my code.
- I have added a release note file, following the [contributors guidelines](https://github.com/deepset-ai/haystack/blob/main/CONTRIBUTING.md#release-notes).
- I have run [pre-commit hooks](https://github.com/deepset-ai/haystack/blob/main/CONTRIBUTING.md#installation) and fixed any issue.

View File

@ -291,6 +291,23 @@ enhancements:
Upgrade transformers to the latest version 4.31.0 so that Haystack can support the new LLama2 models.
```
Each section of the YAML file must follow [reStructuredText formatting](https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html).
For inline code, use double backticks to wrap the code.
```
``OpenAIChatGenerator``
```
For code blocks, use the [code block directive](https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-code-block).
```
.. code:: python
from haystack.dataclasses import ChatMessage
message = ChatMessage.from_user("Hello!")
print(message.text)
```
You can now add the file to the same branch containing the code changes. Your release note will be part of your pull
request and reviewed along with any code you changed.