diff --git a/.github/ISSUE_TEMPLATE/analyse.yml b/.github/ISSUE_TEMPLATE/analyse.yml new file mode 100644 index 0000000..bfe028a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/analyse.yml @@ -0,0 +1,72 @@ +name: 🔍 Analyse +description: Undersøg og vurder et emne, produkt eller en problemstilling +title: "[Analyse]: " +labels: ["analysis"] +body: + - type: markdown + attributes: + value: | + Brug denne skabelon til analyser af produkter, teknologier, processer eller arkitekturmæssige problemstillinger. + + - type: textarea + id: emne + attributes: + label: Hvad skal analyseres? + description: Beskriv kort analysens emne. + placeholder: Fx Produkt, CRM-løsninger, integrationsarkitektur eller governance. + validations: + required: true + + - type: textarea + id: baggrund + attributes: + label: Baggrund + description: Hvorfor er analysen relevant? + placeholder: Hvilket behov eller hvilken udfordring ligger bag? + validations: + required: true + + - type: textarea + id: maalgruppe + attributes: + label: Målgruppe + description: Beskriv relevante brugere eller roller. + placeholder: Fx produktforvaltere, administratorer, andre i OS2-fællesskabet. + validations: + required: false + + - type: textarea + id: kandidater + attributes: + label: Mulige løsninger eller kandidater + description: Hvilke produkter, teknologier eller tilgange bør indgå i analysen? + placeholder: Angiv de løsninger eller tilgange, der ønskes undersøgt. + validations: + required: false + + - type: textarea + id: kriterier + attributes: + label: Evalueringskriterier + description: Hvilke kriterier skal løsningerne vurderes ud fra? + placeholder: Fx funktionalitet, modenhed, licens, integration, sikkerhed, fællesskab og vedligeholdelse. + validations: + required: false + + - type: textarea + id: anbefaling + attributes: + label: Foreløbig anbefaling + description: Er der allerede en foreløbig vurdering eller hypotese? + placeholder: Hvis du allerede har en forventning eller anbefaling, kan den beskrives her. + validations: + required: false + + - type: textarea + id: referencer + attributes: + label: Referencer + description: Links til dokumentation, projekter eller anden relevant information. + placeholder: Dokumentation, GitHub-projekter, artikler eller andre relevante kilder. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..f964ddf --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,6 @@ +blank_issues_enabled: false + +contact_links: + - name: 📖 Projektets README + url: https://github.com/OS2sandbox/relations-platform/blob/main/README.md + about: Læs projektets formål, arbejdsprincipper og dokumentation, før du opretter et issue. diff --git a/.github/ISSUE_TEMPLATE/ide.yml b/.github/ISSUE_TEMPLATE/ide.yml new file mode 100644 index 0000000..a2d092b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/ide.yml @@ -0,0 +1,63 @@ +name: 💡 Idé +description: Foreslå en idé, mulighed eller retning for projektet +title: "[Idé]: " +labels: ["idé"] +body: + - type: markdown + attributes: + value: | + Brug denne skabelon til idéer, forslag eller muligheder, som endnu ikke nødvendigvis er modne nok til en konkret opgave. + + - type: textarea + id: beskrivelse + attributes: + label: Kort beskrivelse + description: Beskriv idéen kort og konkret. + placeholder: Hvad går idéen ud på? + validations: + required: true + + - type: textarea + id: problem + attributes: + label: Hvilket problem eller behov adresserer idéen? + description: Beskriv hvorfor idéen er relevant. + placeholder: Hvilket behov, problem eller mulighed handler dette om? + validations: + required: true + + - type: textarea + id: maalgruppe + attributes: + label: Hvem har gavn af idéen? + description: Beskriv relevante brugere eller roller. + placeholder: Fx produktforvaltere, administratorer, andre i OS2-fællesskabet. + validations: + required: false + + - type: textarea + id: forslag + attributes: + label: Mulig løsning eller retning + description: Beskriv eventuelt hvordan idéen kunne realiseres. + placeholder: Har du et forslag til løsning, produkt, proces eller tilgang? + validations: + required: false + + - type: textarea + id: aabne_spoergsmaal + attributes: + label: Åbne spørgsmål + description: Hvad mangler at blive afklaret? + placeholder: Hvilke spørgsmål bør undersøges, før idéen kan blive til en analyse eller opgave? + validations: + required: false + + - type: textarea + id: links + attributes: + label: Links og referencer + description: Tilføj relevante links, eksempler eller inspiration. + placeholder: Links til projekter, dokumentation, artikler eller lignende. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/opgave.yml b/.github/ISSUE_TEMPLATE/opgave.yml new file mode 100644 index 0000000..70f2809 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/opgave.yml @@ -0,0 +1,63 @@ +name: ✅ Opgave +description: Beskriv en konkret opgave, der skal udføres +title: "[Opgave]: " +labels: ["task"] +body: + - type: markdown + attributes: + value: | + Brug denne skabelon til konkrete opgaver, som kan planlægges og udføres. + + - type: textarea + id: beskrivelse + attributes: + label: Beskrivelse + description: Beskriv kort opgaven. + placeholder: Hvad skal udføres? + validations: + required: true + + - type: textarea + id: formaal + attributes: + label: Formål + description: Hvorfor skal opgaven udføres? + placeholder: Hvad er formålet eller den ønskede effekt? + validations: + required: true + + - type: textarea + id: leverancer + attributes: + label: Forventede leverancer + description: Hvad forventes opgaven at resultere i? + placeholder: Fx opdateret dokumentation, analyse, beslutningsoplæg eller implementering. + validations: + required: true + + - type: textarea + id: accept + attributes: + label: Acceptkriterier + description: Hvornår betragtes opgaven som løst? + placeholder: Beskriv de kriterier, der skal være opfyldt. + validations: + required: false + + - type: textarea + id: afhaengigheder + attributes: + label: Afhængigheder + description: Er opgaven afhængig af andre issues, beslutninger eller projekter? + placeholder: Referér gerne til andre issues med #nummer. + validations: + required: false + + - type: textarea + id: noter + attributes: + label: Yderligere noter + description: Eventuelle supplerende oplysninger. + placeholder: Links, kommentarer eller anden relevant information. + validations: + required: false diff --git a/README.md b/README.md index a32f82b..fe20d65 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,211 @@ # relations-platform Projektet sætter scenen for arbejdet med at udvikle en samlende samarbejds/relations/administrations -platform til OS2-fællesskabet + +# Arbejdsprincipper for projektet + +## Formål + +Dette repository er projektets fælles arbejdsrum. + +Her samles: + +- projektets opgaver +- dialog og idéudvikling +- analyser og beslutninger +- dokumentation +- konfiguration af platformen + +Projektets mål er **ikke at udvikle ny software**, men at identificere, evaluere og implementere en samlet platform baseret på eksisterende open source-produkter. + +--- + +# Princip 1 – GitHub er den fælles sandhed + +Projektets aktiviteter dokumenteres i GitHub. + +Det betyder, at: + +- opgaver oprettes som **Issues** +- beslutninger dokumenteres i repository'et +- ændringer gennemgås via **Pull Requests** +- projektets status følges i **GitHub Projects** + +Information bør så vidt muligt ikke "gemmes" i mails eller private noter. + +--- + +# Princip 2 – Issues beskriver arbejde + +Et **Issue** repræsenterer et konkret stykke arbejde. + +Det kan eksempelvis være: + +- en workshop +- en analyse af et produkt +- en beslutning +- en implementeringsopgave +- dokumentation +- en forbedring + +Et Issue bør som minimum beskrive: + +- formål +- forventet leverance +- acceptkriterier +- ansvarlig(e) +- relevante labels + +Store aktiviteter opdeles i mindre Issues, så fremdriften bliver synlig. + +--- + +# Princip 3 – GitHub Projects giver overblik + +GitHub Projects anvendes til projektstyring. + +Alle relevante Issues tilknyttes projektet og flyttes gennem workflowet. + +Eksempel: + +```text +Backlog + ↓ +Klar + ↓ +I gang + ↓ +Review / Afventer + ↓ +Afsluttet +``` + +Projects giver et samlet overblik over status, ansvar og fremdrift. + +--- + +# Princip 4 – Pull Requests kvalitetssikrer ændringer + +Alle væsentlige ændringer foretages gennem en **Pull Request**. + +Det gælder både: + +- dokumentation +- analyser +- arkitekturbeslutninger +- konfiguration +- scripts +- kode (hvis projektet senere udvikler software) + +Pull Requests giver mulighed for: + +- review +- kommentarer +- fælles ejerskab +- sporbar historik + +--- + +# Princip 5 – Beslutninger dokumenteres + +Projektets væsentlige beslutninger skal kunne findes igen. + +Eksempler: + +- valg af produkter +- fravalg af produkter +- integrationsprincipper +- arkitektur +- governance + +En beslutning bør beskrive: + +- baggrund +- alternativer +- beslutning +- begrundelse +- konsekvenser + +--- + +# Princip 6 – Transparens + +Projektet bygger på åbenhed. + +Derfor bør: + +- analyser være tilgængelige +- beslutninger dokumenteres +- diskussioner være åbne +- projektets status kunne følges af alle deltagere + +Målet er, at alle kan forstå projektets udvikling og beslutningsgrundlag. + +--- + +# Princip 7 – Genbrug før nyudvikling + +Projektets grundlæggende princip er: + +> Konfigurer, integrer og anvend eksisterende open source-løsninger frem for at udvikle ny software. + +Ved vurdering af produkter prioriteres blandt andet: + +- modenhed +- aktivt community +- åbne standarder +- integrationsmuligheder +- dokumentation +- driftsmæssig bæredygtighed + +--- + +# Sammenhæng mellem GitHub-funktionerne + +| Funktion | Formål | +|----------|--------| +| **Issues** | Konkrete opgaver og leverancer | +| **Projects** | Planlægning, prioritering og status | +| **Pull Requests** | Review og godkendelse af ændringer | + +--- + +# Typisk arbejdsproces + +```text +Idé eller behov + │ + ▼ +Issue + │ + ▼ +Analyse / Implementering + │ + ▼ +Pull Request + │ + ▼ +Review + │ + ▼ +Merge + │ + ▼ +Issue afsluttes +``` + +--- + +# Vejen videre + +Når projektet modnes, kan disse principper suppleres med: + +- Issue-skabeloner +- Pull Request-skabeloner +- Navngivningskonventioner +- Labels og kategorier +- Definition of Done +- Beslutningsskabeloner (ADR) +- Governance og roller +- Retningslinjer for møder og workshops + +Målet er at holde arbejdsformen enkel, gennemsigtig og let at deltage i, samtidig med at projektets viden og beslutninger bevares og kan genfindes. diff --git a/dokumentation/README.md b/dokumentation/README.md new file mode 100644 index 0000000..a8080cb --- /dev/null +++ b/dokumentation/README.md @@ -0,0 +1,21 @@ +# Dokumentation + +Denne mappe indeholder projektets samlede dokumentation. + +## Indhold + +| Område | Beskrivelse | +|--------|-------------| +| `krav/` | Behov, krav og prioriteringer | +| `workshops/` | Workshopmateriale og referater | +| `analyser/` | Vurderinger af relevante open source-produkter | +| `beslutninger/` | Projektets beslutningsnotater | +| `arkitektur/` | Beskrivelse af platform og integrationer | +| `billeder/` | Diagrammer, skærmbilleder og illustrationer | + +## Centrale dokumenter + +- `vision.md` +- `projektbeskrivelse.md` +- `roadmap.md` +- `styring-og-roller.md` diff --git a/dokumentation/_templates/README.md b/dokumentation/_templates/README.md new file mode 100644 index 0000000..d8916df --- /dev/null +++ b/dokumentation/_templates/README.md @@ -0,0 +1,3 @@ +# Templates + +Denne mappe indeholder skabeloner til dokumentation i projektet. diff --git a/dokumentation/analyser/README.md b/dokumentation/analyser/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/analyser/README.md @@ -0,0 +1 @@ + diff --git a/dokumentation/arkitektur/README.md b/dokumentation/arkitektur/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/arkitektur/README.md @@ -0,0 +1 @@ + diff --git a/dokumentation/beslutninger/README.md b/dokumentation/beslutninger/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/beslutninger/README.md @@ -0,0 +1 @@ + diff --git a/dokumentation/komponenter/README.md b/dokumentation/komponenter/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/komponenter/README.md @@ -0,0 +1 @@ + diff --git a/dokumentation/krav/README.md b/dokumentation/krav/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/krav/README.md @@ -0,0 +1 @@ + diff --git a/dokumentation/projektbeskrivelse.md b/dokumentation/projektbeskrivelse.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/projektbeskrivelse.md @@ -0,0 +1 @@ + diff --git a/dokumentation/roadmap.md b/dokumentation/roadmap.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/roadmap.md @@ -0,0 +1 @@ + diff --git a/dokumentation/styring-og-roller.md b/dokumentation/styring-og-roller.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/styring-og-roller.md @@ -0,0 +1 @@ + diff --git a/dokumentation/vision.md b/dokumentation/vision.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/vision.md @@ -0,0 +1 @@ + diff --git a/dokumentation/workshops/README.md b/dokumentation/workshops/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/dokumentation/workshops/README.md @@ -0,0 +1 @@ +