From b5d21750bf3242614c5931dd1963c3f23a30fe9b Mon Sep 17 00:00:00 2001 From: Mark West <66728126+MWest2020@users.noreply.github.com> Date: Fri, 7 Feb 2025 09:46:16 +0100 Subject: [PATCH 1/3] Create CONTRIBUTING.md --- CONTRIBUTING.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..177a75a --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,42 @@ +# Contributing to Conduction + +Welkom bij de codebase van Conduction! We waarderen je bijdragen en hanteren een aantal richtlijnen om samenwerking soepel te laten verlopen. Lees dit document goed door voordat je een pull request (PR) indient. + +## πŸš€ Hoe Bijdragen + +1. **Issues Checken** + - Controleer of er al een bestaand issue is voor je verandering. + - Als je een nieuw issue aanmaakt, gebruik de juiste labels en duidelijke titels. + +2. **Werken met Git & Branches** + - Gebruik altijd feature branches (`feature/naam-van-feature`) + - Bugfixes op `bugfix/naam-van-bug` + - Release branches worden beheerd door de tech lead. + +3. **Code Standaarden** + - Houd je aan **PSR-2** coding style. + - Documenteer code met **DocBlock** commentaar. + - Gebruik linting tools zoals ESLint en PHP-CS-Fixer waar nodig. + +4. **Pull Requests (PRs)** + - Zorg dat je code werkt vΓ³Γ³r je een PR indient. + - Voeg een beschrijving toe en link relevante issues. + - Laat minimaal één teamlid een review doen. + - Geen PR’s direct naar `main`! Gebruik `develop` als staging branch. + +5. **Tests & Kwaliteit** + - Schrijf unit tests voor nieuwe functionaliteit. + - Code coverage moet minimaal **80%** zijn. + - Gebruik **Jest** voor frontend tests en **PHPUnit** voor backend tests. + +6. **Beveiliging & Gevoelige Data** + - **NOOIT** API keys, wachtwoorden of tokens in de repo pushen. + - Zorg dat `.env` bestanden **niet** worden gecommit. + - Volg de beveiligingsrichtlijnen in `TEAM_MANIFESTO.md`. + +## πŸ”— Verdere Documentatie + +- **Team werkafspraken & proces:** Zie [`TEAM_MANIFESTO.md`](TEAM_MANIFESTO.md) +- **Scrum & dagelijkse workflow:** Zie [`WORK_AGREEMENTS.md`](WORK_AGREEMENTS.md) + +Bedankt voor je bijdrage! πŸš€ From 4924fc86060be155b2a9ab591f36025bc9cca828 Mon Sep 17 00:00:00 2001 From: Mwest2020 Date: Fri, 7 Feb 2025 09:55:59 +0100 Subject: [PATCH 2/3] team --- TEAM_MANIFESTO.md | 38 ++++++++++++++++++++++++++++++++++++++ WORK_AGREEMENTS.md | 31 +++++++++++++++++++++++++++++++ 2 files changed, 69 insertions(+) create mode 100644 TEAM_MANIFESTO.md create mode 100644 WORK_AGREEMENTS.md diff --git a/TEAM_MANIFESTO.md b/TEAM_MANIFESTO.md new file mode 100644 index 0000000..1302484 --- /dev/null +++ b/TEAM_MANIFESTO.md @@ -0,0 +1,38 @@ +# πŸ† Team Manifesto - Conduction + +Welkom bij Conduction! Dit document beschrijft de algemene teamafspraken en processen binnen onze organisatie. + +## 🌍 Missie & Kernwaarden + +Wij geloven in: +- **Democratie** – Iedereen heeft een stem in beslissingen. +- **Inclusiviteit** – Toegankelijkheid en respect voor iedereen. +- **Transparantie** – Open communicatie en heldere verwachtingen. + +## πŸ”₯ Algemene Werkafspraken + +1. **Scrum & Agile** + - We werken in **sprints van 2 weken**. + - Refinements en planningen zijn verplicht. + - Issues zonder refinement worden **niet** opgepakt. + +2. **Dagelijkse Rituelen** + - Stand-up om **10:00** – Verplicht tenzij expliciet afgemeld. + - Stand-down om **16:30** – Kort verslag in Slack. + - Sprint Review elke **2 weken** op vrijdag. + +3. **Samenwerking & Communicatie** + - Feedback is **constructief en direct**. + - We gebruiken Slack voor dagelijkse communicatie. + - Jira is de **enige bron van waarheid** voor taken en voortgang. + +4. **Beveiliging & Compliance** + - **Geen gevoelige data in repositories** (API keys, wachtwoorden). + - **VPN & BitLocker verplicht** bij remote werken. + - Security incidenten direct melden en escaleren. + +5. **Verwijzing naar Gedetailleerde Afspraken** + - Voor technische bijdragen, zie [`CONTRIBUTING.md`](CONTRIBUTING.md). + - Voor dagelijkse workflow en tijdsregistratie, zie [`WORK_AGREEMENTS.md`](WORK_AGREEMENTS.md). + +πŸš€ Laten we samen bouwen aan een sterk team en een geweldige organisatie! diff --git a/WORK_AGREEMENTS.md b/WORK_AGREEMENTS.md new file mode 100644 index 0000000..cc94526 --- /dev/null +++ b/WORK_AGREEMENTS.md @@ -0,0 +1,31 @@ +# πŸ“œ Work Agreements - Conduction + +Dit document bevat de dagelijkse werkafspraken voor het development team van Conduction. + +## πŸ”„ Scrum & Sprint Afspraken +- Sprints duren **2 weken**. +- Refinement is verplicht voordat een issue wordt opgepakt. +- Issues zonder duidelijke acceptatiecriteria worden **niet** ontwikkeld. +- Timeboxing: Duurt een issue langer dan gepland? **Escaleren in de stand-down**. + +## ⏱ Tijdschrijven & Issue Management +- **Geen issue = geen werk** – alle taken moeten in Jira staan. +- Uren moeten **voor vrijdag 12:00** gelogd zijn in Tempo. +- Gebruik correcte **labels en story points** voor een realistische sprintplanning. +- Onvoorziene problemen worden **direct** gemeld in Slack en de volgende stand-up. + +## πŸ›  Dagelijkse Werkregels +- **Stand-up:** Elke werkdag om **10:00**, tenzij vooraf afgemeld. +- **Stand-down:** Dagelijkse update in Slack om **16:30**. +- **Sprint Review:** Presentatie van werk om de **2 weken op vrijdag**. + +## πŸ” Beveiliging & Veilig Werken +- **NOOIT** API keys, wachtwoorden of gevoelige data in repositories pushen. +- **VPN verplicht** bij remote werken. +- Issues met security impact krijgen **directe prioriteit** en escaleren naar de tech lead. + +## πŸ“Œ Verwijzingen +- Voor codebijdragen, zie [`CONTRIBUTING.md`](CONTRIBUTING.md). +- Voor algemene teamafspraken, zie [`TEAM_MANIFESTO.md`](TEAM_MANIFESTO.md). + +πŸ”Ή Laten we samenwerken aan een efficiΓ«nte, veilige en plezierige werkomgeving! From 06411c2bcc528efdf37b24af5aa9eff0b1698d4d Mon Sep 17 00:00:00 2001 From: Mark West <66728126+MWest2020@users.noreply.github.com> Date: Fri, 7 Feb 2025 09:59:23 +0100 Subject: [PATCH 3/3] Update WORK_AGREEMENTS.md --- WORK_AGREEMENTS.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/WORK_AGREEMENTS.md b/WORK_AGREEMENTS.md index cc94526..e388508 100644 --- a/WORK_AGREEMENTS.md +++ b/WORK_AGREEMENTS.md @@ -14,6 +14,10 @@ Dit document bevat de dagelijkse werkafspraken voor het development team van Con - Gebruik correcte **labels en story points** voor een realistische sprintplanning. - Onvoorziene problemen worden **direct** gemeld in Slack en de volgende stand-up. +## πŸ”„ Pull Requests & Code Reviews +- Als een pull request wijzigingen vereist, is het aan de ontwikkelaar die de pull request heeft geopend, of de ontwikkelaar die de wijzigingen heeft aangebracht, om deze aan te passen. +- De reviewer of andere ontwikkelaars kunnen helpen bij het oplossen van de gevraagde wijzigingen, indien daarom wordt gevraagd door de ontwikkelaar die de pull request heeft geopend. + ## πŸ›  Dagelijkse Werkregels - **Stand-up:** Elke werkdag om **10:00**, tenzij vooraf afgemeld. - **Stand-down:** Dagelijkse update in Slack om **16:30**.