Kleine änderungen an pre-commits und readme

Einige pre-commits hinzugefügt und in der README dokumentiert.
Eine Pre-commit installationsanleitung wurde zur readme hinzugefügt.
Spellchecker and Markdown whitespace table format
This commit is contained in:
Philipp Horstenkamp 2023-04-12 23:46:41 +02:00
parent a79c5b6560
commit b1bfbe9c2c
Signed by: Philipp
GPG Key ID: DD53EAC36AFB61B4
4 changed files with 68 additions and 20 deletions

View File

@ -21,6 +21,10 @@ repos:
- id: check-case-conflict - id: check-case-conflict
- id: check-symlinks - id: check-symlinks
- id: check-docstring-first - id: check-docstring-first
- id: mixed-line-ending
- id: destroyed-symlinks
- id: debug-statements
- id: pretty-format-json
- repo: https://github.com/psf/black - repo: https://github.com/psf/black
rev: 22.10.0 rev: 22.10.0
@ -38,6 +42,10 @@ repos:
args: [--autofix] args: [--autofix]
- id: pretty-format-yaml - id: pretty-format-yaml
args: [--autofix] args: [--autofix]
- id: pretty-format-toml
args: [ --autofix ]
exclude: (^poetry.lock$)
- repo: https://github.com/domdfcoding/flake2lint - repo: https://github.com/domdfcoding/flake2lint
rev: v0.4.2 rev: v0.4.2
@ -75,3 +83,20 @@ repos:
hooks: hooks:
- id: pyupgrade - id: pyupgrade
args: [--py311-plus] args: [--py311-plus]
- repo: https://github.com/pylint-dev/pylint
rev: v3.0.0a6
hooks: []
# - id: pylint
# args: [--disable=import-error]
- repo: https://github.com/MarcoGorelli/absolufy-imports
rev: v0.3.1
hooks:
- id: absolufy-imports
- repo: https://github.com/pycqa/isort
rev: 5.12.0
hooks:
- id: isort
name: isort (python)

View File

@ -1,2 +1,25 @@
# aki_prj23_transparenzregister # aki_prj23_transparenzregister
## Aufsetzen des Project zur Entwicklung
- clone des Projects
- 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

View File

@ -23,7 +23,7 @@
- Backlog für Ideen und Aufgaben - Backlog für Ideen und Aufgaben
- Meeting-Notes mit besprochenen Themen, Entscheidungen, Terminen und Action-List (Wer arbeitet an welcher Aufgabe?) - Meeting-Notes mit besprochenen Themen, Entscheidungen, Terminen und Action-List (Wer arbeitet an welcher Aufgabe?)
- Projektdurchführung so formal wie möglich, d.h. - Projektdurchführung so formal wie möglich, d.h.
- Beschreibung des Systemkontext: Interaktion mit der Umgebung - Beschreibung des Systemkontexts: Interaktion mit der Umgebung
- Datenmodell: schematische Darstellung der Datenflüsse - Datenmodell: schematische Darstellung der Datenflüsse
- Lasten- / Pflichtenheft mit Kategorisierung - Lasten- / Pflichtenheft mit Kategorisierung
- Vorschlag Frontend von Prof. Arinir: D3.js - Vorschlag Frontend von Prof. Arinir: D3.js
@ -31,15 +31,15 @@
- **Bewertung des Projekts:** - **Bewertung des Projekts:**
- Es muss erkennbar sein, wer welche Aufgabe bearbeitet hat - Es muss erkennbar sein, wer welche Aufgabe bearbeitet hat
- Jeder Teilnehmer soll die Aufgaben der anderen Teilnehmer kennen und ein Verständnis für diese haben (kein tiefes Domänenwissen!) - Jeder Teilnehmer soll die Aufgaben der anderen Teilnehmer kennen und ein Verständnis für diese haben (kein tiefes Domänenwissen!)
- Gesamtplanung und Dokumentation sind Teil des Ergebnis, nicht nur die technische Umsetzung - Gesamtplanung und Dokumentation sind Teil das Ergebnis, nicht nur die technische Umsetzung
- Bewertungsschlüssel: - Bewertungsschlüssel:
| Gewichtung | Aufgabe | | Gewichtung | Aufgabe |
|---|---| |--------------|---------------------------------------------|
| 20% | Vortrag Seminararbeit | | 20% | Vortrag Seminararbeit |
| 20% | Präsentation | | 20% | Präsentation |
| 30% | Implementierung | | 30% | Implementierung |
| 20% | Finaler Bericht (~15 Seiten pro Teilnehmer)| | 20% | Finaler Bericht (~15 Seiten pro Teilnehmer) |
| 10% | Abschlusspräsentation | | 10% | Abschlusspräsentation |
- **Organisatorisches:** - **Organisatorisches:**
@ -53,10 +53,10 @@
## Abgeleitete Action Items ## Abgeleitete Action Items
| Action Item | Verantwortlicher | Deadline | | Action Item | Verantwortlicher | Deadline |
| ----------- | ---------------- | -------- | |-----------------------------------------------------------------------------------------|--------------------|----------------------------------|
| Welche Anforderungen / Erwartungen stellen wir inhaltlich und technisch an das Projekt?| alle | nächstes Weekly/work in progress | | Welche Anforderungen / Erwartungen stellen wir inhaltlich und technisch an das Projekt? | alle | nächstes Weekly/work in progress |
| Erarbeiten von Arbeitspaketen/Aufgaben aus Anforderungen| alle | nächstes Weekly/work in progress | | Erarbeiten von Arbeitspaketen/Aufgaben aus Anforderungen | alle | nächstes Weekly/work in progress |
| Welche Metriken sind notwendig?| alle | nächstes Weekly/work in progress | | Welche Metriken sind notwendig? | alle | nächstes Weekly/work in progress |
| Recherche zu Datenquellen| alle | nächstes Weekly/work in progress | | Recherche zu Datenquellen | alle | nächstes Weekly/work in progress |
| Definition von Meilensteinen| alle | nächstes Weekly | | Definition von Meilensteinen | alle | nächstes Weekly |
| Erstellung eines (groben) Zeitplans| alle | nächstes Weekly | | Erstellung eines (groben) Zeitplans | alle | nächstes Weekly |

View File

@ -17,5 +17,5 @@
## Abgeleitete Action Items ## Abgeleitete Action Items
| Action Item | Verantwortlicher | Deadline | | Action Item | Verantwortlicher | Deadline |
| ----------- | ---------------- | -------- | |-------------|------------------|-----------------|
| Beispiel | Max Mustermann | nächstes Weekly | | Beispiel | Max Mustermann | nächstes Weekly |