Inconsistencies

Output from my favourite LLM.

Not everything seems to be accurate (e.g. ENV variable names), but mostly ok.

# Repository-Analyse: datasharingframework.github.io

**Datum:** 2026-03-08
**Analysiert:** Gesamtes Repository (546+ Markdown-Dateien)
**Site-Typ:** VuePress 2.0 mit vuepress-theme-hope

---

## 1. Tote / Kaputte Links

### 1.1 Broken Internal Link (Kritisch)
- **Datei:** `docs/src/explore/concepts/network-setup.md` (Zeile 19)
- **Link:** `[Authentication: Client/Server Certificates](Authentication)`
- **Problem:** Ziel `Authentication.md` existiert nicht im Repository. Seite wurde vermutlich entfernt.

### 1.2 Inkonsistente Consultation-Hours URL
- `docs/src/posts/2025-11-28-dsfv2-release.md` verlinkt auf `/community/consultationhours` (ohne Bindestrich)
- Korrekte URL ist `/community/consultation-hours` (mit Bindestrich)
- Resultat: Toter Link auf der Blogpost-Seite

### 1.3 Malformed Markdown-Link
- **Datei:** `docs/src/posts/2025-11-12-operaton-release-party.md` (Zeile 33)
- **Problem:** `[LinkedIn]( <https://...>)` - Leerzeichen und spitze Klammern in der URL
- **Fix:** `[LinkedIn](https://...)` verwenden

---

## 2. Verwaiste Seiten (Orphaned Pages)

### 2.1 Seiten ohne Navigation
| Datei | Problem |
|-------|---------|
| `docs/src/explore/concepts/network-setup.md` | Existiert, aber nicht in Sidebar referenziert |
| `docs/src/network-operations/README.md` | Komplett leer, kein Inhalt, nicht verlinkt |
| `docs/src/process-development/api-v2/guides/adding-task-parameters-to-task-profiles.md` | Existiert, aber fehlt in der v2-Sidebar (theme.ts Zeilen 288-300). V1-Pendant ist korrekt verlinkt. |

### 2.2 V1/V2 Guide-Asymmetrie
- V1 hat `setting-targets-for-message-events.md` in der Sidebar
- V2 hat kein Pendant dazu - unklar ob bewusst entfernt oder vergessen

---

## 3. Work-in-Progress Seiten (27 Seiten)

Folgende Seiten zeigen nur "Work in progress" und haben keinen echten Inhalt:

**Explore / For-You:**
- `docs/src/for-you/learn.md`
- `docs/src/explore/use-cases/README.md`
- `docs/src/explore/use-cases/feasibility.md`
- `docs/src/explore/use-cases/num.md`

**Process Development API v2:**
- `docs/src/process-development/api-v2/publishing/publish-on-dsfhub.md`
- `docs/src/process-development/api-v2/tooling/empty-process-plugin.md`
- `docs/src/process-development/api-v2/tooling/ide.md`
- `docs/src/process-development/api-v2/tooling/pipeline-testing.md`
- `docs/src/process-development/api-v2/tooling/maven.md`
- `docs/src/process-development/api-v2/best-practices.md`
- `docs/src/process-development/api-v2/migration.md`
- `docs/src/process-development/api-v2/testing.md`
- `docs/src/process-development/api-v2/create.md`
- `docs/src/process-development/api-v2/get-started.md`

**Process Development API v1 (Tooling/Publishing):**
- Weitere 13+ Seiten im selben Muster

**Empfehlung:** Entweder mit Inhalt fuellen oder aus der Navigation entfernen, um Nutzer nicht zu enttaeuschen.

---

## 4. Leere / Minimal-Dateien

| Datei | Inhalt |
|-------|--------|
| `docs/src/network-operations/README.md` | Komplett leer (0 Bytes Inhalt) |
| `docs/src/s/connection-refused.md` | Nur HTML-Redirect |
| `docs/src/s/error-ssl.md` | Nur HTML-Redirect |
| `docs/src/s/connection-timeout.md` | Nur HTML-Redirect |
| `docs/src/s/read-timeout.md` | Nur HTML-Redirect |
| `docs/src/s/error-http.md` | Nur HTML-Redirect |
| `docs/src/s/unknown-host.md` | Nur HTML-Redirect |
| `docs/src/sprechstunde/readme.md` | Nur HTML-Redirect auf `/community/consultation-hours` |

Die Redirect-Dateien im `/s/`-Verzeichnis sind vermutlich bewusst so angelegt (Kurzlinks fuer Troubleshooting). Die leere `network-operations/README.md` sollte entfernt oder befuellt werden.

---

## 5. Formatierungs-Probleme

### 5.1 Falsch eingerueckte Ueberschriften
- `docs/src/hackathon/hackathon-2026.md` (Zeile 32): ` #### DSF` hat fuehrendes Leerzeichen
- `docs/src/hackathon/index.md` (Zeile 37): ` #### DSF` hat fuehrendes Leerzeichen
- **Problem:** Wird in manchen Markdown-Parsern nicht als Header erkannt

### 5.2 Inkonsistente Sidebar-Referenzen
- Manche Sidebar-Eintraege in `theme.ts` verwenden `.md`-Erweiterung, manche nicht
- Beispiele mit `.md`: `get-started.md`, `old-versions.md`, `concepts/introduction.md`
- Rest: ohne Erweiterung
- **Empfehlung:** Einheitlich ohne `.md` verwenden

---

## 6. Sprachinkonsistenzen (Deutsch/Englisch)

### 6.1 Gemischte Sprachen auf einer Seite
- `docs/src/hackathon/hackathon-2026.md` - Enthalt deutsche und englische Version auf derselben Seite
- `docs/src/hackathon/index.md` - Gleiche Struktur
- **Empfehlung:** Sprachen klar trennen (z.B. Tabs oder separate Seiten)

### 6.2 Deutsche Verzeichnisnamen
- `/sprechstunde/` - Deutsches Wort, Rest der Site ist Englisch
- Wird aber per Redirect auf `/community/consultation-hours` weitergeleitet (konsistent)

---

## 7. TODO-Platzhalter in Installations-Dokumentation

### 7.1 Platzhalter-Variablen (17+ Vorkommen)
In den Installations-Anleitungen mehrerer Versionen finden sich Platzhalter:
- `_TODO_DSF_FHIR_SERVER_EXTERNAL_FQDN_`
- `_TODO_ORGANIZATION_IDENTIFIER_`
- `_TODO_CLIENT_CERTIFICATE_THUMBPRINT_`
- `_TODO_WEBUSER_CLIENT_CERTIFICATE_THUMBPRINT_`
- `_TODO_DSF_FHIR_SERVER_FQDN_`

**Betroffene Versionen:** v1.0.0 bis v1.6.0 (`install.md`)

**Hinweis:** Diese sind vermutlich bewusst als Platzhalter fuer den Nutzer gedacht. Falls ja, sollte das klarer dokumentiert werden (z.B. mit `<PLATZHALTER>` statt `_TODO_...`).

### 7.2 Platzhalter-Domain (61+ Vorkommen)
- `todo.organization.com` wird als Beispiel-Domain verwendet
- Besser waere eine RFC-konforme Beispiel-Domain wie `example.org` oder `hospital.example.com`

---

## 8. Inkonsistente GitHub-Branch-Referenzen

- **API v1** Dateien verlinken auf `github.com/datasharingframework/dsf/blob/main` (Development-Branch)
- **API v2** Dateien verlinken auf `github.com/datasharingframework/dsf/blob/release/2.0.2` (Release-Branch)
- **Problem:** V1-Links zeigen auf aktuellen Entwicklungsstand statt auf den passenden Release-Stand
- **Empfehlung:** V1-Dateien sollten auf den entsprechenden V1-Release-Branch verlinken

---

## 9. Selbstreferenzen ueber Domain

- 704+ Stellen verwenden absolute `dsf.dev`-Links statt relativer Links
- **Risiko:** Bei Domain- oder Strukturaenderungen brechen alle diese Links
- **Empfehlung:** Wo moeglich relative Links verwenden (z.B. `/operations/latest/` statt `https://dsf.dev/operations/latest/`)

---

## 10. Zusammenfassung / Prioritaeten

### Hoch (sollte zeitnah behoben werden)
1. **Broken Link** in `network-setup.md` -> `Authentication` existiert nicht
2. **Broken Link** in `2025-11-28-dsfv2-release.md` -> `/community/consultationhours` (falsche URL)
3. **Fehlender Sidebar-Eintrag** fuer `api-v2/guides/adding-task-parameters-to-task-profiles.md`
4. **Malformed Link** in `2025-11-12-operaton-release-party.md`

### Mittel (sollte aufgeraeumt werden)
5. **27 Work-in-Progress Seiten** - entweder befuellen oder aus Navigation entfernen
6. **Leere Datei** `network-operations/README.md` entfernen
7. **Falsch eingerueckte Headers** in Hackathon-Seiten
8. **Platzhalter-Domain** `todo.organization.com` durch `example.org` ersetzen

### Niedrig (Kosmetik / Best Practices)
9. Sidebar-Referenzen einheitlich ohne `.md` machen
10. Absolute `dsf.dev`-Links durch relative Links ersetzen
11. GitHub-Branch-Referenzen fuer V1-Docs korrigieren
12. Hackathon-Seiten: Sprachmischung aufloesen

---

---

# TEIL 2: Inhaltliche Analyse

---

## 11. Rechtschreib- und Grammatikfehler

### 11.1 Startseite (`index.md`)
| Zeile | Fehler | Korrektur |
|-------|--------|-----------|
| 14 | `"informations about Use-Cases"` | `"information about Use-Cases"` |
| 44 | `"a immersive, hand-on experience"` | `"an immersive, hands-on experience"` |

### 11.2 Explore / Concepts
| Datei | Zeile | Fehler | Korrektur |
|-------|-------|--------|-----------|
| `concepts/network-setup.md` | 5 | `"used to except Task resources"` | `"accept"` |
| `concepts/network-setup.md` | 9 | `"will be delegate as http"` | `"delegated"` |
| `concepts/network-setup.md` | 16 | `"patient date (IDAT)"` | `"patient data"` |
| `concepts/basics.md` | 5 | `"the standards were using"` | `"we're using"` |
| `concepts/introduction.md` | 15 | `"user-centeric"` | `"user-centric"` |
| `concepts/introduction.md` | 15 | `"heterogeny structures"` | `"heterogeneous"` |
| `concepts/allow-list.md` | 10 | `"and and parent organizations"` | doppeltes "and" |
| `concepts/allow-list.md` | 13 | `"Managment"` | `"Management"` |
| `concepts/security.md` | 6 | `"Basics Security"` | `"Security Basics"` |
| `use-cases/num.md` | 18 | `"communincation"` | `"communication"` |

### 11.3 Community
| Datei | Zeile | Fehler | Korrektur |
|-------|-------|--------|-----------|
| `community/contribute/README.md` | 15 | `"Help us testing"` | `"Help us test"` |
| `community/contribute/README.md` | 21 | `"Help us improving"` | `"Help us improve"` |
| `community/team.md` | 55 | `"FDGP+"` | `"FDPG+"` |
| `events/tutorials/MIE2023.md` | 43 | `"your planning"` | `"you're planning"` |

### 11.4 Operations v2.0.2
| Datei | Zeile | Fehler | Korrektur |
|-------|-------|--------|-----------|
| `root-certificates.md` | 6 | `"client oder server"` (Deutsch!) | `"or"` |
| `install-plugins.md` | 8 | `"compatable"` | `"compatible"` |
| `install-plugins.md` | 54 | `"compabile"` | `"compatible"` |
| `install-plugins.md` | 21 | `"involves copy the"` | `"involves copying the"` |
| `passwords-secrets.md` | 6 | `"the fist line"` | `"the first line"` |
| `bpe/access-control.md` | 25 | `"thumprint"` | `"thumbprint"` |
| `bpe/access-control.md` | 25 | `"rule-enty"` | `"rule-entry"` |
| `bpe/access-control.md` | 65 | `"practionier-roles"` | `"practitioner-roles"` |
| `bpe/oidc.md` | 27 | `"Additional ODIC Configuration"` | `"OIDC"` |
| `fhir/oidc.md` | 34 | `"Additional ODIC Configuration"` | `"OIDC"` |
| `bpe/oidc.md` | 29 | `"parameter are specify on"` | `"are specified on"` |
| `fhir/oidc.md` | 36 | `"parameter are specify on"` | `"are specified on"` |
| `bpe/oidc.md` | 31 | `"If not specify"` | `"If not specified"` |
| `fhir/oidc.md` | 38 | `"If not specify"` | `"If not specified"` |
| `fhir/access-control.md` | 30 | `"priviledges"` | `"privileges"` |
| `fhir/access-control.md` | 82 | `"If the uses has"` | `"If the user has"` |
| `bpe/configuration.md` | 63 | `"different user then in"` | `"than"` |
| `bpe/configuration.md` | 365 | `"corresponging"` | `"corresponding"` |
| `bpe/configuration.md` | 453 | `"S/MIMIE"` | `"S/MIME"` |
| `bpe/configuration.md` | 584 | `"changes to tit"` | `"changes to it"` |
| `bpe/configuration.md` | 840 | `"set tor true"` | `"set to true"` |
| `fhir/configuration.md` | 134 | `"different user then"` | `"than"` |
| `fhir/configuration.md` | 188 | `"FQDN that resolve"` | `"resolves to"` |
| `fhir/configuration.md` | 428 | `"set tor true"` | `"set to true"` |
| `bpe/logging.md` | 6 | `"output there messages"` | `"their"` |
| `fhir/logging.md` | 6 | `"output there messages"` | `"their"` |
| `fhir-reverse-proxy/config.md` | 62 | `"certificates excepted"` | `"expected"` oder `"accepted"` |
| `bpe-reverse-proxy/config.md` | 62 | `"certificates excepted"` | `"expected"` oder `"accepted"` |
| `bpe/fhir-client-connections.md` | 10 | `"AS part of"` | `"As part of"` |

### 11.5 Process Development
| Datei | Zeile | Fehler | Korrektur |
|-------|-------|--------|-----------|
| `api-v1/fhir/task.md` | 8 | `"includes a splicing for"` | `"slicing"` |
| `api-v2/fhir/task.md` | 8 | `"includes a splicing for"` | `"slicing"` |
| `api-v1/fhir/task.md` | 17 | `"It is import to know"` | `"important"` |
| `api-v2/fhir/task.md` | 17 | `"It is import to know"` | `"important"` |
| `api-v1/dsf/requester-and-recipient.md` | 195 | `"recipeint"` | `"recipient"` |
| `api-v2/dsf/requester-and-recipient.md` | 195 | `"recipeint"` | `"recipient"` |
| `api-v1/guides/configuring-read-access-tags.md` | 149 | `"extenion"` | `"extension"` |
| `api-v2/guides/configuring-read-access-tags.md` | 149 | `"extenion"` | `"extension"` |
| `api-v1/guides/creating-activity-definitions.md` | 668 | `"AcitivityDefinition"` | `"ActivityDefinition"` |
| `api-v2/guides/creating-activity-definitions.md` | 674 | `"AcitivityDefinition"` | `"ActivityDefinition"` |
| `api-v1/tooling/maven.md` | Titel | `"Ressources"` | `"Resources"` |
| `api-v2/tooling/maven.md` | Titel | `"Ressources"` | `"Resources"` |
| `api-v2/dsf/draft-task-resources.md` | 8 | `"instead the usual"` | `"instead of the usual"` |
| `api-v1/dsf/message-delegates.md` | - | `"getAdditionalInputParamters"` | `"getAdditionalInputParameters"` |
| `api-v1/guides/adding-task-input-...-profiles.md` | 166 | `"Type.input.value[x]"` | `"Task.input.value[x]"` |
| `api-v2/guides/adding-task-...-profiles.md` | 167 | `"Type.input.value[x]"` | `"Task.input.value[x]"` |

### 11.6 Typo in Dateinamen (nicht einfach zu fixen)
- `api-v1/guides/managing-mutiple-incoming-messages-...md` - `"mutiple"` statt `"multiple"`
- `api-v2/guides/managing-mutiple-incoming-messages-...md` - identisch

### 11.7 Blog Posts
| Datei | Zeile | Fehler | Korrektur |
|-------|-------|--------|-----------|
| `posts/2025-11-18-dsf-meet-up-2025.md` | 6 | `"contributoers"` | `"contributors"` |
| `posts/2025-07-04-follow-up-fhir-devdays.md` | 32 | `"dicsussion"` | `"discussion"` |
| `posts/2025-07-04-follow-up-fhir-devdays.md` | 23 | `"lesson learned"` | `"lessons learned"` |
| `posts/2025-11-28-dsfv2-release.md` | 5 | `"Github!."` | Doppelte Interpunktion |
| `posts/2025-04-23-spring-school-2025.md` | 45 | `"hackathon.The"` | Leerzeichen fehlt |
| `posts/2025-11-12-operaton-release-party.md` | 18 | `"contributors.We"` | Leerzeichen fehlt |
| `posts/2023-05-30-mie-award-2023.md` | 2 | `title: " Rolf Hansen..."` | Fuehrendes Leerzeichen im Titel |

---

## 12. Veraltete Inhalte

### 12.1 Startseite (`index.md`)
- **Zeile 43-50:** Spring School 2026 (24.-26. Feb) wird noch als "Registrations are now open!" beworben, obwohl das Event bereits stattgefunden hat.
- **Zeile 59:** DSF v2 wird als "ready for deployment on the **test infrastructure**" beschrieben -- moeglicherweise schon auf Produktiv-Infrastruktur verfuegbar.

### 12.2 Explore / Concepts
- **`network-setup.md` Zeile 12:** Referenziert Version 0.3.0 -- aktuelle Version ist 2.0.2. Extrem veraltet.
- **`basics.md` Zeile 18:** "150 specified resources" -- FHIR R4 hat inzwischen mehr als 150 Ressourcen.
- **`introduction.md` Zeile 9:** Link zu `gesundheitsforschung-bmbf.de` -- Ministerium wurde umbenannt (jetzt BMFTR). `index.md` nutzt bereits `gesundheitsforschung-bmftr.de`.
- **`feasibility.md` Zeile 11:** "Federal Ministry of Research and Education" -- alte Bezeichnung.

### 12.3 Community
- **`events/README.md`:** Januar/Februar-2026-Events stehen noch unter "Upcoming Events" -- sind jetzt vergangen.
- **`events/README.md` Zeile 10:** "2nd DSF Spring School" -- auf `index.md` wird es als "third edition" bezeichnet. Widerspruch.
- **`team.md` Zeile 51:** Link zu `gesundheitsforschung-bmbf.de` statt neuer BMFTR-Domain.
- **`contribute/code.md` Zeile 56:** "Java JDK 17" -- sollte verifiziert werden ob DSF 2.0 noch JDK 17 nutzt.
- **`events/tutorials/2022-09-10-GMDS2022-dev.md` Zeile 24:** Link zu `github.com/highmed/dsf-process-tutorial` -- alte GitHub-Organisation.
- **`events/tutorials/2023-05-30-MIE2023.md` Zeile 17:** Link zu `github.com/highmed/highmed-dsf` -- alte Organisation.

### 12.4 Operations v2.0.2
- **`index.md` Zeile 6:** `"DSF 2.x is the new upcoming release"` -- DSF 2.x ist bereits released. Sollte "current major release" heissen.
- **`install.md` Zeile 39:** GEANT-TCS-Zertifikate "until the end of February 2026" -- Datum ist abgelaufen.
- **`bpe/logging.md` + `fhir/logging.md`:** Log-Beispiele zeigen Version `2.0.1` statt `2.0.2`.
- **`root-certificates.md` Zeile 41-45, 84-90:** Download-Links zeigen auf `/download/1.9.0/` statt `2.0.2`.

### 12.5 Hackathon
- **`hackathon/index.md`:** Auto-Redirect nach 5 Sekunden zu totem Konferenzraum (Event war am 20.01.2026).

### 12.6 Spring School
- **`spring-school/index.md`:** Anmeldefrist 15. Feb 2026 ist abgelaufen.

---

## 13. Falsche Docker-Image-Versionen (Operations v2.0.2)

| Datei | Zeile | Falsches Image | Korrektur |
|-------|-------|----------------|-----------|
| `bpe/oidc.md` | 38 | `ghcr.io/datasharingframework/bpe:1.5.2` | `:2.0.2` |
| `fhir/oidc.md` | 45 | `ghcr.io/datasharingframework/fhir:1.5.2` | `:2.0.2` |

---

## 14. Inhaltliche Widersprueche und technische Fehler

### 14.1 Operations v2.0.2

**install.md -- Widerspruch bei chown-Angaben:**
- Zeile 98: `ssl_certificate_file.pem (chmod: 440, chown: root:4101)`
- Zeile 122: Beispiel zeigt `chown fhir:docker` -- widerspricht den Angaben oben

**bpe/access-control.md -- Falsche Rollenanzahl:**
- Zeile 25: "assigning three DSF roles" -- Beispiel zeigt aber nur eine Rolle (`ADMIN`). Text wurde vermutlich von FHIR-Beispiel kopiert (dort gibt es 3 Rollen).

**passwords-secrets.md -- Inkonsistenter Secret-Name:**
- Docker-Secret heisst `api_key` mit Datei `./secrets/oidc_client.secret`, aber der Service referenziert `oidc_client_secret`. Namen passen nicht zusammen.

**install.md -- Veralteter Dateiname:**
- Zeile 190: `db_user_camunda.password` -- `upgrade-from-1.md` benennt explizit um zu `db_user_engine.password`. Neuinstallationen sollten den neuen Namen nutzen.

**fhir/configuration.md -- Falscher Defaultwert:**
- Zeile 237, 251: Default `STYLE_TEXT` existiert nicht in den gueltigen Optionen (`JSON_ECS`, `JSON_GCP`, `JSON_GELF`, `JSON_LOGSTASH`, `TEXT_MDC`, `TEXT`). Vermutlich `TEXT` gemeint.

**fhir/configuration.md -- Falsche Variablenreferenz:**
- Zeile 362: Referenziert `DEV_DSF_BPE_PROXY_NOPROXY` -- sollte im FHIR-Kontext `DEV_DSF_PROXY_NOPROXY` heissen.

**fhir/access-control.md -- Doppel-Hash im Link:**
- Zeile 8: `(configuration##dev-dsf-fhir-client-certificate)` -- doppeltes `#`, sollte einfach sein.

**fhir-reverse-proxy/configuration.md -- Duplizierter Abschnitt:**
- Zeile 72-83: `SSL_CERTIFICATE_CHAIN_FILE`-Abschnitt ist doppelt vorhanden.

**upgrade-from-2.md + upgrade-from-1.md -- Fehlender Schritt:**
- Nummerierung springt von Schritt 3 direkt zu Schritt 5 (kein Schritt 4).

**index.md -- Fehlender Link:**
- Nur "Install" und "Upgrade from 1.9.0" verlinkt. "Upgrade from 2.0.1" (`upgrade-from-2.md`) fehlt, obwohl die Datei existiert.

### 14.2 Process Development

**api-v2/bpmn/index.md -- Camunda statt Operaton:**
- Zeile 7: Referenziert `"the Camunda 7 dialect from the Camunda Modeler"` -- DSF 2.0 nutzt Operaton, nicht mehr Camunda 7. Die Unterseiten (gateways, service-tasks) verlinken korrekt auf Operaton-Docs, aber die Index-Seite nicht.

**api-v2/dsf/activities.md -- Copy-Paste-Fehler:**
- Zeile 37: `"ServiceTask is the interface to be implemented for ... Task Listener"` -- sollte `"UserTaskListener"` heissen, nicht `"ServiceTask"`.

**api-v2/bpmn/execution-listeners.md -- Abgebrochener Inhalt:**
- Datei endet mitten im Satz: `"See [Activities]"` -- kein Link-Ziel, keine weiteren Inhalte. Seite ist kaputt.

**ValueSet-Guide -- Falscher Pfad (beide API-Versionen):**
- `api-v1/guides/creating-valuesets-for-dsf-processes.md` Zeile 61: `src/main/resources/fhir/CodeSystem` -- sollte `fhir/ValueSet` sein.
- `api-v2/guides/creating-valuesets-for-dsf-processes.md` Zeile 62: Gleicher Fehler.

**api-v2 Seiten die unveraenderte v1-Kopien sind:**
- `fhir/valueset.md` -- identisch mit v1, verlinkt noch auf `main`-Branch statt `release/2.0.2`
- `fhir/questionnaire-and-questionnaireresponse.md` -- identisch mit v1
- `bpmn/sequence-flow.md` -- identisch
- `bpmn/conditions.md` -- weitgehend identisch

---

## 15. Duplizierter Inhalt

| Seite A | Seite B | Beschreibung |
|---------|---------|-------------|
| `explore/concepts/README.md` | `for-you/index.md` | Nahezu identischer Inhalt ("DSF for your project"). `for-you/index.md` hat zusaetzlich einen Meta-Redirect. |
| `hackathon/index.md` | `hackathon/hackathon-2026.md` | Gleicher Inhalt, `index.md` hat zusaetzlich Auto-Redirect zum Konferenzraum. |
| `explore/README.md` | - | Listet nur Concepts-Links, verlinkt nicht auf Use-Cases, Awards, Publications (Geschwister-Seiten). |

---

## 16. Sicherheitsbedenken

**OIDC-Beispiele enthalten Inline-Secrets:**
- `bpe/oidc.md` Zeile 51 und `fhir/oidc.md` Zeile 58: `DEV_DSF_SERVER_AUTH_OIDC_CLIENT_SECRET: n9bCMtjugv3Y_.szktXyQ2RH5se+J%o3`
- Secret wird direkt als Environment-Variable gesetzt statt ueber `_FILE`-Variante mit Docker Secrets. Widerspricht der empfohlenen Praxis aus `passwords-secrets.md`.

---

## 17. Stilinkonsistenzen

### 17.1 Emoji-Nutzung
- `concepts/basics.md`: `:fire:` Emoji neben "HL7 FHIR"
- `community/communication.md`: `:rocket:` Emoji
- `news/fhir-devdays-2025/index.md`: Mail-Emoji
- Rest der Dokumentation: Keine Emojis
- **Empfehlung:** Einheitlich -- entweder ueberall oder nirgends.

### 17.2 Terminologie
- British vs. American English gemischt: `"organisation"` vs. `"organization"`, `"centre"` vs. `"center"`
- `"whitelist"` (security.md) vs. `"allow list"` (allow-list.md)
- Alte GitHub-Organisation `"highmed"` in aelteren Tutorial-Seiten vs. `"datasharingframework"` aktuell

### 17.3 Auskommentierter Code
- `network-setup.md` Zeilen 25-68: Grosser Block auskommentierter nginx/haproxy-Konfiguration
- `process-plugins.md` Zeilen 47-59: Auskommentierter Abschnitt mit `"blablabla"` Platzhaltertext
- `operations/v2.0.2/index.md` Zeilen 18-23: Auskommentierte `<releas-notes>`-Komponente (mit Typo im Tag-Namen)
- `bpe/fhir-client-connections.md` Zeile 25: `` -- offener Developer-TODO

---

## 18. Fehlende kritische Inhalte

| Was fehlt | Wo erwartet | Warum kritisch |
|-----------|-------------|----------------|
| **Migration Guide v1->v2** | `api-v2/migration.md` | DSF 2.0 ist released, Nutzer migrieren aktiv. Seite ist nur WIP. |
| **API v2 Get-Started** | `api-v2/get-started.md` | Einstiegsseite fuer neue v2-Nutzer ist WIP -- schlecht fuer Onboarding. |
| **User Tasks in v2 BPMN** | `api-v2/bpmn/` | v1 hat `user-tasks.md`, v2 hat kein Pendant. |
| **Upgrade von 2.0.1** | `operations/v2.0.2/index.md` | Link fehlt auf Index-Seite, obwohl `upgrade-from-2.md` existiert. |

---

## Aktualisierte Zusammenfassung / Prioritaeten

### Kritisch
1. **Falsche Docker-Image-Versionen** (`1.5.2` statt `2.0.2`) in OIDC-Beispielen
2. **Abgebrochene Seite** `api-v2/bpmn/execution-listeners.md` -- Inhalt endet mitten im Satz
3. **Copy-Paste-Fehler** in `api-v2/dsf/activities.md` -- "ServiceTask" statt "UserTaskListener"
4. **Widerspruch bei chown** in `operations/v2.0.2/install.md`
5. **"Camunda 7"** in `api-v2/bpmn/index.md` statt Operaton
6. **Falscher Pfad** in ValueSet-Guides (`CodeSystem` statt `ValueSet`)

### Hoch
7. Alle bisherigen "Hoch"-Punkte (tote Links, fehlende Sidebar-Eintraege)
8. **50+ Rechtschreibfehler** ueber alle Seiten verteilt (siehe Tabellen oben)
9. **Veraltete Startseite** -- Spring School 2026 noch als "open" beworben
10. **GEANT-TCS-Zertifikats-Hinweis** abgelaufen (Ende Feb 2026)
11. **Fehlender Upgrade-Link** auf v2.0.2 Index-Seite
12. **"ODIC" statt "OIDC"** in Ueberschriften der OIDC-Seiten
13. **Deutsches Wort "oder"** in englischer Doku (`root-certificates.md`)

### Mittel
14. **27 WIP-Seiten** (inkl. kritische wie Migration Guide und Get-Started v2)
15. **Duplizierter Inhalt** (for-you/index.md, hackathon-Seiten)
16. **Veraltete Ministry-Links** (BMBF -> BMFTR)
17. **Alte GitHub-Organisation** "highmed" in Tutorial-Links
18. **Inline OIDC Secret** in Beispielen widerspricht Best Practice

### Niedrig
19. Emoji-Konsistenz, British/American English, auskommentierter Code
20. Linter-Version hardcoded, Docker Compose `version` deprecated

---

## Statistiken (aktualisiert)

| Metrik | Wert |
|--------|------|
| Markdown-Dateien gesamt | 546+ |
| Dateien mit Front Matter | ~533 |
| Operations-Versionen | 18 (v1.0.0 - v2.0.2) |
| Work-in-Progress Seiten | 27 |
| Tote/kaputte Links | 4 |
| Verwaiste Seiten | 3 |
| TODO-Platzhalter | 78+ |
| Rechtschreib-/Grammatikfehler | 50+ |
| Veraltete Inhalte | 12+ Stellen |
| Technische Fehler/Widersprueche | 10+ |
| Duplizierter Inhalt | 2 Seitenpaare |
| Fehlende kritische Inhalte | 4 Seiten |

Datei	Zeile	Fehler	Korrektur
`concepts/network-setup.md`	5	`"used to except Task resources"`	`"accept"`
`concepts/network-setup.md`	9	`"will be delegate as http"`	`"delegated"`
`concepts/network-setup.md`	16	`"patient date (IDAT)"`	`"patient data"`
`concepts/basics.md`	5	`"the standards were using"`	`"we're using"`
`concepts/introduction.md`	15	`"user-centeric"`	`"user-centric"`
`concepts/introduction.md`	15	`"heterogeny structures"`	`"heterogeneous"`
`concepts/allow-list.md`	10	`"and and parent organizations"`	doppeltes "and"
`concepts/allow-list.md`	13	`"Managment"`	`"Management"`
`concepts/security.md`	6	`"Basics Security"`	`"Security Basics"`
`use-cases/num.md`	18	`"communincation"`	`"communication"`

Datei	Zeile	Fehler	Korrektur
`community/contribute/README.md`	15	`"Help us testing"`	`"Help us test"`
`community/contribute/README.md`	21	`"Help us improving"`	`"Help us improve"`
`community/team.md`	55	`"FDGP+"`	`"FDPG+"`
`events/tutorials/MIE2023.md`	43	`"your planning"`	`"you're planning"`

Datei	Zeile	Fehler	Korrektur
`root-certificates.md`	6	`"client oder server"` (Deutsch!)	`"or"`
`install-plugins.md`	8	`"compatable"`	`"compatible"`
`install-plugins.md`	54	`"compabile"`	`"compatible"`
`install-plugins.md`	21	`"involves copy the"`	`"involves copying the"`
`passwords-secrets.md`	6	`"the fist line"`	`"the first line"`
`bpe/access-control.md`	25	`"thumprint"`	`"thumbprint"`
`bpe/access-control.md`	25	`"rule-enty"`	`"rule-entry"`
`bpe/access-control.md`	65	`"practionier-roles"`	`"practitioner-roles"`
`bpe/oidc.md`	27	`"Additional ODIC Configuration"`	`"OIDC"`
`fhir/oidc.md`	34	`"Additional ODIC Configuration"`	`"OIDC"`
`bpe/oidc.md`	29	`"parameter are specify on"`	`"are specified on"`
`fhir/oidc.md`	36	`"parameter are specify on"`	`"are specified on"`
`bpe/oidc.md`	31	`"If not specify"`	`"If not specified"`
`fhir/oidc.md`	38	`"If not specify"`	`"If not specified"`
`fhir/access-control.md`	30	`"priviledges"`	`"privileges"`
`fhir/access-control.md`	82	`"If the uses has"`	`"If the user has"`
`bpe/configuration.md`	63	`"different user then in"`	`"than"`
`bpe/configuration.md`	365	`"corresponging"`	`"corresponding"`
`bpe/configuration.md`	453	`"S/MIMIE"`	`"S/MIME"`
`bpe/configuration.md`	584	`"changes to tit"`	`"changes to it"`
`bpe/configuration.md`	840	`"set tor true"`	`"set to true"`
`fhir/configuration.md`	134	`"different user then"`	`"than"`
`fhir/configuration.md`	188	`"FQDN that resolve"`	`"resolves to"`
`fhir/configuration.md`	428	`"set tor true"`	`"set to true"`
`bpe/logging.md`	6	`"output there messages"`	`"their"`
`fhir/logging.md`	6	`"output there messages"`	`"their"`
`fhir-reverse-proxy/config.md`	62	`"certificates excepted"`	`"expected"` oder `"accepted"`
`bpe-reverse-proxy/config.md`	62	`"certificates excepted"`	`"expected"` oder `"accepted"`
`bpe/fhir-client-connections.md`	10	`"AS part of"`	`"As part of"`

Datei	Zeile	Fehler	Korrektur
`api-v1/fhir/task.md`	8	`"includes a splicing for"`	`"slicing"`
`api-v2/fhir/task.md`	8	`"includes a splicing for"`	`"slicing"`
`api-v1/fhir/task.md`	17	`"It is import to know"`	`"important"`
`api-v2/fhir/task.md`	17	`"It is import to know"`	`"important"`
`api-v1/dsf/requester-and-recipient.md`	195	`"recipeint"`	`"recipient"`
`api-v2/dsf/requester-and-recipient.md`	195	`"recipeint"`	`"recipient"`
`api-v1/guides/configuring-read-access-tags.md`	149	`"extenion"`	`"extension"`
`api-v2/guides/configuring-read-access-tags.md`	149	`"extenion"`	`"extension"`
`api-v1/guides/creating-activity-definitions.md`	668	`"AcitivityDefinition"`	`"ActivityDefinition"`
`api-v2/guides/creating-activity-definitions.md`	674	`"AcitivityDefinition"`	`"ActivityDefinition"`
`api-v1/tooling/maven.md`	Titel	`"Ressources"`	`"Resources"`
`api-v2/tooling/maven.md`	Titel	`"Ressources"`	`"Resources"`
`api-v2/dsf/draft-task-resources.md`	8	`"instead the usual"`	`"instead of the usual"`
`api-v1/dsf/message-delegates.md`	-	`"getAdditionalInputParamters"`	`"getAdditionalInputParameters"`
`api-v1/guides/adding-task-input-...-profiles.md`	166	`"Type.input.value[x]"`	`"Task.input.value[x]"`
`api-v2/guides/adding-task-...-profiles.md`	167	`"Type.input.value[x]"`	`"Task.input.value[x]"`

Datei	Zeile	Fehler	Korrektur
`posts/2025-11-18-dsf-meet-up-2025.md`	6	`"contributoers"`	`"contributors"`
`posts/2025-07-04-follow-up-fhir-devdays.md`	32	`"dicsussion"`	`"discussion"`
`posts/2025-07-04-follow-up-fhir-devdays.md`	23	`"lesson learned"`	`"lessons learned"`
`posts/2025-11-28-dsfv2-release.md`	5	`"Github!."`	Doppelte Interpunktion
`posts/2025-04-23-spring-school-2025.md`	45	`"hackathon.The"`	Leerzeichen fehlt
`posts/2025-11-12-operaton-release-party.md`	18	`"contributors.We"`	Leerzeichen fehlt
`posts/2023-05-30-mie-award-2023.md`	2	`title: " Rolf Hansen..."`	Fuehrendes Leerzeichen im Titel

Datei	Problem
`docs/src/explore/concepts/network-setup.md`	Existiert, aber nicht in Sidebar referenziert
`docs/src/network-operations/README.md`	Komplett leer, kein Inhalt, nicht verlinkt
`docs/src/process-development/api-v2/guides/adding-task-parameters-to-task-profiles.md`	Existiert, aber fehlt in der v2-Sidebar (theme.ts Zeilen 288-300). V1-Pendant ist korrekt verlinkt.

Datei	Inhalt
`docs/src/network-operations/README.md`	Komplett leer (0 Bytes Inhalt)
`docs/src/s/connection-refused.md`	Nur HTML-Redirect
`docs/src/s/error-ssl.md`	Nur HTML-Redirect
`docs/src/s/connection-timeout.md`	Nur HTML-Redirect
`docs/src/s/read-timeout.md`	Nur HTML-Redirect
`docs/src/s/error-http.md`	Nur HTML-Redirect
`docs/src/s/unknown-host.md`	Nur HTML-Redirect
`docs/src/sprechstunde/readme.md`	Nur HTML-Redirect auf `/community/consultation-hours`

Zeile	Fehler	Korrektur
14	`"informations about Use-Cases"`	`"information about Use-Cases"`
44	`"a immersive, hand-on experience"`	`"an immersive, hands-on experience"`

Datei	Zeile	Falsches Image	Korrektur
`bpe/oidc.md`	38	`ghcr.io/datasharingframework/bpe:1.5.2`	`:2.0.2`
`fhir/oidc.md`	45	`ghcr.io/datasharingframework/fhir:1.5.2`	`:2.0.2`

Seite A	Seite B	Beschreibung
`explore/concepts/README.md`	`for-you/index.md`	Nahezu identischer Inhalt ("DSF for your project"). `for-you/index.md` hat zusaetzlich einen Meta-Redirect.
`hackathon/index.md`	`hackathon/hackathon-2026.md`	Gleicher Inhalt, `index.md` hat zusaetzlich Auto-Redirect zum Konferenzraum.
`explore/README.md`	-	Listet nur Concepts-Links, verlinkt nicht auf Use-Cases, Awards, Publications (Geschwister-Seiten).

Was fehlt	Wo erwartet	Warum kritisch
Migration Guide v1->v2	`api-v2/migration.md`	DSF 2.0 ist released, Nutzer migrieren aktiv. Seite ist nur WIP.
API v2 Get-Started	`api-v2/get-started.md`	Einstiegsseite fuer neue v2-Nutzer ist WIP -- schlecht fuer Onboarding.
User Tasks in v2 BPMN	`api-v2/bpmn/`	v1 hat `user-tasks.md`, v2 hat kein Pendant.
Upgrade von 2.0.1	`operations/v2.0.2/index.md`	Link fehlt auf Index-Seite, obwohl `upgrade-from-2.md` existiert.

Metrik	Wert
Markdown-Dateien gesamt	546+
Dateien mit Front Matter	~533
Operations-Versionen	18 (v1.0.0 - v2.0.2)
Work-in-Progress Seiten	27
Tote/kaputte Links	4
Verwaiste Seiten	3
TODO-Platzhalter	78+
Rechtschreib-/Grammatikfehler	50+
Veraltete Inhalte	12+ Stellen
Technische Fehler/Widersprueche	10+
Duplizierter Inhalt	2 Seitenpaare
Fehlende kritische Inhalte	4 Seiten

Inconsistencies #151

Description

Repository-Analyse: datasharingframework.github.io

1. Tote / Kaputte Links

1.1 Broken Internal Link (Kritisch)

1.2 Inkonsistente Consultation-Hours URL

1.3 Malformed Markdown-Link

2. Verwaiste Seiten (Orphaned Pages)

2.1 Seiten ohne Navigation

2.2 V1/V2 Guide-Asymmetrie

3. Work-in-Progress Seiten (27 Seiten)

4. Leere / Minimal-Dateien

5. Formatierungs-Probleme

5.1 Falsch eingerueckte Ueberschriften

5.2 Inkonsistente Sidebar-Referenzen

6. Sprachinkonsistenzen (Deutsch/Englisch)

6.1 Gemischte Sprachen auf einer Seite

6.2 Deutsche Verzeichnisnamen

7. TODO-Platzhalter in Installations-Dokumentation

7.1 Platzhalter-Variablen (17+ Vorkommen)

7.2 Platzhalter-Domain (61+ Vorkommen)

8. Inkonsistente GitHub-Branch-Referenzen

9. Selbstreferenzen ueber Domain

10. Zusammenfassung / Prioritaeten

Hoch (sollte zeitnah behoben werden)

Mittel (sollte aufgeraeumt werden)

Niedrig (Kosmetik / Best Practices)

TEIL 2: Inhaltliche Analyse

11. Rechtschreib- und Grammatikfehler

11.1 Startseite (index.md)

11.2 Explore / Concepts

11.3 Community

11.4 Operations v2.0.2

11.5 Process Development

11.6 Typo in Dateinamen (nicht einfach zu fixen)

11.7 Blog Posts

12. Veraltete Inhalte

12.1 Startseite (index.md)

12.2 Explore / Concepts

12.3 Community

12.4 Operations v2.0.2

12.5 Hackathon

12.6 Spring School

13. Falsche Docker-Image-Versionen (Operations v2.0.2)

14. Inhaltliche Widersprueche und technische Fehler

14.1 Operations v2.0.2

14.2 Process Development

15. Duplizierter Inhalt

16. Sicherheitsbedenken

17. Stilinkonsistenzen

17.1 Emoji-Nutzung

17.2 Terminologie

17.3 Auskommentierter Code

18. Fehlende kritische Inhalte

Aktualisierte Zusammenfassung / Prioritaeten

Kritisch

Hoch

Mittel

Niedrig

Statistiken (aktualisiert)

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

11.1 Startseite (`index.md`)

12.1 Startseite (`index.md`)