mirror of
https://github.com/fhswf/aki_prj23_transparenzregister.git
synced 2025-06-21 23:43:55 +02:00
Moved contribution rules and format documentation to CONTRIBUTING.md (#19)
* Moved contribution rules and format documentation to CONTRIBUTING.md
This commit is contained in:
36
CONTRIBUTING.md
Normal file
36
CONTRIBUTING.md
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
# Contribution guidelines
|
||||||
|
|
||||||
|
|
||||||
|
## Code style
|
||||||
|
|
||||||
|
We defined to use the following formats:
|
||||||
|
- Whitespace Formatting by [Black](https://github.com/psf/black)
|
||||||
|
- Docstrings Style see the examples provided by [sphinx napoleon](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html) Types in the docstrings are optional but should be consistent per module.
|
||||||
|
- Import Order by [isort](https://pycqa.github.io/isort/)
|
||||||
|
- Strict Typing of function headers see the examples provided by the [mypy](https://mypy.readthedocs.io/en/stable/cheat_sheet_py3.html) documentation.
|
||||||
|
|
||||||
|
## Language
|
||||||
|
|
||||||
|
We decided to use english on everything close to code but will write longer texts that are not close to the code in german.
|
||||||
|
|
||||||
|
## Pre-Commit installation
|
||||||
|
|
||||||
|
- clone the project
|
||||||
|
- install the following python package:
|
||||||
|
- `pre-commit`
|
||||||
|
|
||||||
|
- execute the command `pre-commit install` to insert the git githook into your local repository.
|
||||||
|
- for more information read [Python Pre-Commit](https://pre-commit.com/)
|
||||||
|
- the following code format rules are so enforced:
|
||||||
|
- Whitespace formatierung:
|
||||||
|
- Python-[Black](https://github.com/psf/black)
|
||||||
|
- leading whitespace in all files
|
||||||
|
- Auto format: yaml, toml, ini
|
||||||
|
- Import norm by:
|
||||||
|
- [isort](https://pycqa.github.io/isort/)
|
||||||
|
- absolut module path
|
||||||
|
- Validierung:
|
||||||
|
- yaml, toml, json, xml
|
||||||
|
- Secret detection
|
||||||
|
- python normen ([pep8](https://peps.python.org/pep-0008/)) with [flake8](https://flake8.pycqa.org/en/latest/)
|
||||||
|
- type checking with ([mypy](https://github.com/python/mypy))
|
24
README.md
24
README.md
@ -1,25 +1,5 @@
|
|||||||
# aki_prj23_transparenzregister
|
# aki_prj23_transparenzregister
|
||||||
|
|
||||||
## Aufsetzen des Project zur Entwicklung
|
## Contributions
|
||||||
|
|
||||||
- clone des Projects
|
See the [CONTRIBUTING.md](CONTRIBUTING.md) about how code should be formatted and what kind of rules we set ourselves.
|
||||||
- installieren der folgenden Python Packete:
|
|
||||||
- `pre-commit`
|
|
||||||
|
|
||||||
- führe das kommando `pre-commit install` aus um die pre-commit hooks für das repository zu aktiviere.
|
|
||||||
- für weiterführende Informationen [Python Pre-Commit](https://pre-commit.com/)
|
|
||||||
- Folgende Formats-konventionen wurden so implementiert
|
|
||||||
- Whitespace formatierung:
|
|
||||||
- Python: Black
|
|
||||||
- leading whitespace
|
|
||||||
- Auto framat yaml, toml, ini
|
|
||||||
- Import nomierung
|
|
||||||
- isort
|
|
||||||
- absolutify
|
|
||||||
- Validierung
|
|
||||||
- yaml, toml, json, xml
|
|
||||||
- Secret detection
|
|
||||||
- python normen
|
|
||||||
- type checking
|
|
||||||
- pep8 (flake8)
|
|
||||||
- file schemas
|
|
||||||
|
Reference in New Issue
Block a user