docs: propose new contribution guidance (#1750)

# What does this PR do?

Propose new contribution guidance.

Signed-off-by: Sébastien Han <seb@redhat.com>
This commit is contained in:
Sébastien Han 2025-03-21 17:08:02 +01:00 committed by GitHub
parent 00917ef5b2
commit 636d97207f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -135,9 +135,11 @@ uv sync
## Coding Style
* Comments should provide meaningful insights into the code. Avoid filler comments that simply describe the next step, as they create unnecessary clutter, same goes for docstrings.
* Prefer comments to clarify surprising behavior and/or relationships between parts of the code rather than explain what the next line of code does.
* Catching exceptions, prefer using a specific exception type rather than a broad catch-all like `Exception`.
* Error messages should be prefixed with "Failed to ..."
* 4 spaces for indentation rather than tabs
* 80 character line length
* ...
## Common Tasks