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)
- Broken Link in
network-setup.md -> Authentication existiert nicht
- Broken Link in
2025-11-28-dsfv2-release.md -> /community/consultationhours (falsche URL)
- Fehlender Sidebar-Eintrag fuer
api-v2/guides/adding-task-parameters-to-task-profiles.md
- Malformed Link in
2025-11-12-operaton-release-party.md
Mittel (sollte aufgeraeumt werden)
- 27 Work-in-Progress Seiten - entweder befuellen oder aus Navigation entfernen
- Leere Datei
network-operations/README.md entfernen
- Falsch eingerueckte Headers in Hackathon-Seiten
- Platzhalter-Domain
todo.organization.com durch example.org ersetzen
Niedrig (Kosmetik / Best Practices)
- Sidebar-Referenzen einheitlich ohne
.md machen
- Absolute
dsf.dev-Links durch relative Links ersetzen
- GitHub-Branch-Referenzen fuer V1-Docs korrigieren
- 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: <!-- TODO default values --> -- 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
- Falsche Docker-Image-Versionen (
1.5.2 statt 2.0.2) in OIDC-Beispielen
- Abgebrochene Seite
api-v2/bpmn/execution-listeners.md -- Inhalt endet mitten im Satz
- Copy-Paste-Fehler in
api-v2/dsf/activities.md -- "ServiceTask" statt "UserTaskListener"
- Widerspruch bei chown in
operations/v2.0.2/install.md
- "Camunda 7" in
api-v2/bpmn/index.md statt Operaton
- Falscher Pfad in ValueSet-Guides (
CodeSystem statt ValueSet)
Hoch
- Alle bisherigen "Hoch"-Punkte (tote Links, fehlende Sidebar-Eintraege)
- 50+ Rechtschreibfehler ueber alle Seiten verteilt (siehe Tabellen oben)
- Veraltete Startseite -- Spring School 2026 noch als "open" beworben
- GEANT-TCS-Zertifikats-Hinweis abgelaufen (Ende Feb 2026)
- Fehlender Upgrade-Link auf v2.0.2 Index-Seite
- "ODIC" statt "OIDC" in Ueberschriften der OIDC-Seiten
- Deutsches Wort "oder" in englischer Doku (
root-certificates.md)
Mittel
- 27 WIP-Seiten (inkl. kritische wie Migration Guide und Get-Started v2)
- Duplizierter Inhalt (for-you/index.md, hackathon-Seiten)
- Veraltete Ministry-Links (BMBF -> BMFTR)
- Alte GitHub-Organisation "highmed" in Tutorial-Links
- Inline OIDC Secret in Beispielen widerspricht Best Practice
Niedrig
- Emoji-Konsistenz, British/American English, auskommentierter Code
- 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 |
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)
docs/src/explore/concepts/network-setup.md(Zeile 19)[Authentication: Client/Server Certificates](Authentication)Authentication.mdexistiert nicht im Repository. Seite wurde vermutlich entfernt.1.2 Inkonsistente Consultation-Hours URL
docs/src/posts/2025-11-28-dsfv2-release.mdverlinkt auf/community/consultationhours(ohne Bindestrich)/community/consultation-hours(mit Bindestrich)1.3 Malformed Markdown-Link
docs/src/posts/2025-11-12-operaton-release-party.md(Zeile 33)[LinkedIn]( <https://...>)- Leerzeichen und spitze Klammern in der URL[LinkedIn](https://...)verwenden2. Verwaiste Seiten (Orphaned Pages)
2.1 Seiten ohne Navigation
docs/src/explore/concepts/network-setup.mddocs/src/network-operations/README.mddocs/src/process-development/api-v2/guides/adding-task-parameters-to-task-profiles.md2.2 V1/V2 Guide-Asymmetrie
setting-targets-for-message-events.mdin der Sidebar3. 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.mddocs/src/explore/use-cases/README.mddocs/src/explore/use-cases/feasibility.mddocs/src/explore/use-cases/num.mdProcess Development API v2:
docs/src/process-development/api-v2/publishing/publish-on-dsfhub.mddocs/src/process-development/api-v2/tooling/empty-process-plugin.mddocs/src/process-development/api-v2/tooling/ide.mddocs/src/process-development/api-v2/tooling/pipeline-testing.mddocs/src/process-development/api-v2/tooling/maven.mddocs/src/process-development/api-v2/best-practices.mddocs/src/process-development/api-v2/migration.mddocs/src/process-development/api-v2/testing.mddocs/src/process-development/api-v2/create.mddocs/src/process-development/api-v2/get-started.mdProcess Development API v1 (Tooling/Publishing):
Empfehlung: Entweder mit Inhalt fuellen oder aus der Navigation entfernen, um Nutzer nicht zu enttaeuschen.
4. Leere / Minimal-Dateien
docs/src/network-operations/README.mddocs/src/s/connection-refused.mddocs/src/s/error-ssl.mddocs/src/s/connection-timeout.mddocs/src/s/read-timeout.mddocs/src/s/error-http.mddocs/src/s/unknown-host.mddocs/src/sprechstunde/readme.md/community/consultation-hoursDie Redirect-Dateien im
/s/-Verzeichnis sind vermutlich bewusst so angelegt (Kurzlinks fuer Troubleshooting). Die leerenetwork-operations/README.mdsollte entfernt oder befuellt werden.5. Formatierungs-Probleme
5.1 Falsch eingerueckte Ueberschriften
docs/src/hackathon/hackathon-2026.md(Zeile 32):#### DSFhat fuehrendes Leerzeichendocs/src/hackathon/index.md(Zeile 37):#### DSFhat fuehrendes Leerzeichen5.2 Inkonsistente Sidebar-Referenzen
theme.tsverwenden.md-Erweiterung, manche nicht.md:get-started.md,old-versions.md,concepts/introduction.md.mdverwenden6. Sprachinkonsistenzen (Deutsch/Englisch)
6.1 Gemischte Sprachen auf einer Seite
docs/src/hackathon/hackathon-2026.md- Enthalt deutsche und englische Version auf derselben Seitedocs/src/hackathon/index.md- Gleiche Struktur6.2 Deutsche Verzeichnisnamen
/sprechstunde/- Deutsches Wort, Rest der Site ist Englisch/community/consultation-hoursweitergeleitet (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.comwird als Beispiel-Domain verwendetexample.orgoderhospital.example.com8. Inkonsistente GitHub-Branch-Referenzen
github.com/datasharingframework/dsf/blob/main(Development-Branch)github.com/datasharingframework/dsf/blob/release/2.0.2(Release-Branch)9. Selbstreferenzen ueber Domain
dsf.dev-Links statt relativer Links/operations/latest/statthttps://dsf.dev/operations/latest/)10. Zusammenfassung / Prioritaeten
Hoch (sollte zeitnah behoben werden)
network-setup.md->Authenticationexistiert nicht2025-11-28-dsfv2-release.md->/community/consultationhours(falsche URL)api-v2/guides/adding-task-parameters-to-task-profiles.md2025-11-12-operaton-release-party.mdMittel (sollte aufgeraeumt werden)
network-operations/README.mdentfernentodo.organization.comdurchexample.orgersetzenNiedrig (Kosmetik / Best Practices)
.mdmachendsf.dev-Links durch relative Links ersetzenTEIL 2: Inhaltliche Analyse
11. Rechtschreib- und Grammatikfehler
11.1 Startseite (
index.md)"informations about Use-Cases""information about Use-Cases""a immersive, hand-on experience""an immersive, hands-on experience"11.2 Explore / Concepts
concepts/network-setup.md"used to except Task resources""accept"concepts/network-setup.md"will be delegate as http""delegated"concepts/network-setup.md"patient date (IDAT)""patient data"concepts/basics.md"the standards were using""we're using"concepts/introduction.md"user-centeric""user-centric"concepts/introduction.md"heterogeny structures""heterogeneous"concepts/allow-list.md"and and parent organizations"concepts/allow-list.md"Managment""Management"concepts/security.md"Basics Security""Security Basics"use-cases/num.md"communincation""communication"11.3 Community
community/contribute/README.md"Help us testing""Help us test"community/contribute/README.md"Help us improving""Help us improve"community/team.md"FDGP+""FDPG+"events/tutorials/MIE2023.md"your planning""you're planning"11.4 Operations v2.0.2
root-certificates.md"client oder server"(Deutsch!)"or"install-plugins.md"compatable""compatible"install-plugins.md"compabile""compatible"install-plugins.md"involves copy the""involves copying the"passwords-secrets.md"the fist line""the first line"bpe/access-control.md"thumprint""thumbprint"bpe/access-control.md"rule-enty""rule-entry"bpe/access-control.md"practionier-roles""practitioner-roles"bpe/oidc.md"Additional ODIC Configuration""OIDC"fhir/oidc.md"Additional ODIC Configuration""OIDC"bpe/oidc.md"parameter are specify on""are specified on"fhir/oidc.md"parameter are specify on""are specified on"bpe/oidc.md"If not specify""If not specified"fhir/oidc.md"If not specify""If not specified"fhir/access-control.md"priviledges""privileges"fhir/access-control.md"If the uses has""If the user has"bpe/configuration.md"different user then in""than"bpe/configuration.md"corresponging""corresponding"bpe/configuration.md"S/MIMIE""S/MIME"bpe/configuration.md"changes to tit""changes to it"bpe/configuration.md"set tor true""set to true"fhir/configuration.md"different user then""than"fhir/configuration.md"FQDN that resolve""resolves to"fhir/configuration.md"set tor true""set to true"bpe/logging.md"output there messages""their"fhir/logging.md"output there messages""their"fhir-reverse-proxy/config.md"certificates excepted""expected"oder"accepted"bpe-reverse-proxy/config.md"certificates excepted""expected"oder"accepted"bpe/fhir-client-connections.md"AS part of""As part of"11.5 Process Development
api-v1/fhir/task.md"includes a splicing for""slicing"api-v2/fhir/task.md"includes a splicing for""slicing"api-v1/fhir/task.md"It is import to know""important"api-v2/fhir/task.md"It is import to know""important"api-v1/dsf/requester-and-recipient.md"recipeint""recipient"api-v2/dsf/requester-and-recipient.md"recipeint""recipient"api-v1/guides/configuring-read-access-tags.md"extenion""extension"api-v2/guides/configuring-read-access-tags.md"extenion""extension"api-v1/guides/creating-activity-definitions.md"AcitivityDefinition""ActivityDefinition"api-v2/guides/creating-activity-definitions.md"AcitivityDefinition""ActivityDefinition"api-v1/tooling/maven.md"Ressources""Resources"api-v2/tooling/maven.md"Ressources""Resources"api-v2/dsf/draft-task-resources.md"instead the usual""instead of the usual"api-v1/dsf/message-delegates.md"getAdditionalInputParamters""getAdditionalInputParameters"api-v1/guides/adding-task-input-...-profiles.md"Type.input.value[x]""Task.input.value[x]"api-v2/guides/adding-task-...-profiles.md"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- identisch11.7 Blog Posts
posts/2025-11-18-dsf-meet-up-2025.md"contributoers""contributors"posts/2025-07-04-follow-up-fhir-devdays.md"dicsussion""discussion"posts/2025-07-04-follow-up-fhir-devdays.md"lesson learned""lessons learned"posts/2025-11-28-dsfv2-release.md"Github!."posts/2025-04-23-spring-school-2025.md"hackathon.The"posts/2025-11-12-operaton-release-party.md"contributors.We"posts/2023-05-30-mie-award-2023.mdtitle: " Rolf Hansen..."12. Veraltete Inhalte
12.1 Startseite (
index.md)12.2 Explore / Concepts
network-setup.mdZeile 12: Referenziert Version 0.3.0 -- aktuelle Version ist 2.0.2. Extrem veraltet.basics.mdZeile 18: "150 specified resources" -- FHIR R4 hat inzwischen mehr als 150 Ressourcen.introduction.mdZeile 9: Link zugesundheitsforschung-bmbf.de-- Ministerium wurde umbenannt (jetzt BMFTR).index.mdnutzt bereitsgesundheitsforschung-bmftr.de.feasibility.mdZeile 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.mdZeile 10: "2nd DSF Spring School" -- aufindex.mdwird es als "third edition" bezeichnet. Widerspruch.team.mdZeile 51: Link zugesundheitsforschung-bmbf.destatt neuer BMFTR-Domain.contribute/code.mdZeile 56: "Java JDK 17" -- sollte verifiziert werden ob DSF 2.0 noch JDK 17 nutzt.events/tutorials/2022-09-10-GMDS2022-dev.mdZeile 24: Link zugithub.com/highmed/dsf-process-tutorial-- alte GitHub-Organisation.events/tutorials/2023-05-30-MIE2023.mdZeile 17: Link zugithub.com/highmed/highmed-dsf-- alte Organisation.12.4 Operations v2.0.2
index.mdZeile 6:"DSF 2.x is the new upcoming release"-- DSF 2.x ist bereits released. Sollte "current major release" heissen.install.mdZeile 39: GEANT-TCS-Zertifikate "until the end of February 2026" -- Datum ist abgelaufen.bpe/logging.md+fhir/logging.md: Log-Beispiele zeigen Version2.0.1statt2.0.2.root-certificates.mdZeile 41-45, 84-90: Download-Links zeigen auf/download/1.9.0/statt2.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)
bpe/oidc.mdghcr.io/datasharingframework/bpe:1.5.2:2.0.2fhir/oidc.mdghcr.io/datasharingframework/fhir:1.5.2:2.0.214. Inhaltliche Widersprueche und technische Fehler
14.1 Operations v2.0.2
install.md -- Widerspruch bei chown-Angaben:
ssl_certificate_file.pem (chmod: 440, chown: root:4101)chown fhir:docker-- widerspricht den Angaben obenbpe/access-control.md -- Falsche Rollenanzahl:
ADMIN). Text wurde vermutlich von FHIR-Beispiel kopiert (dort gibt es 3 Rollen).passwords-secrets.md -- Inkonsistenter Secret-Name:
api_keymit Datei./secrets/oidc_client.secret, aber der Service referenziertoidc_client_secret. Namen passen nicht zusammen.install.md -- Veralteter Dateiname:
db_user_camunda.password--upgrade-from-1.mdbenennt explizit um zudb_user_engine.password. Neuinstallationen sollten den neuen Namen nutzen.fhir/configuration.md -- Falscher Defaultwert:
STYLE_TEXTexistiert nicht in den gueltigen Optionen (JSON_ECS,JSON_GCP,JSON_GELF,JSON_LOGSTASH,TEXT_MDC,TEXT). VermutlichTEXTgemeint.fhir/configuration.md -- Falsche Variablenreferenz:
DEV_DSF_BPE_PROXY_NOPROXY-- sollte im FHIR-KontextDEV_DSF_PROXY_NOPROXYheissen.fhir/access-control.md -- Doppel-Hash im Link:
(configuration##dev-dsf-fhir-client-certificate)-- doppeltes#, sollte einfach sein.fhir-reverse-proxy/configuration.md -- Duplizierter Abschnitt:
SSL_CERTIFICATE_CHAIN_FILE-Abschnitt ist doppelt vorhanden.upgrade-from-2.md + upgrade-from-1.md -- Fehlender Schritt:
index.md -- Fehlender Link:
upgrade-from-2.md) fehlt, obwohl die Datei existiert.14.2 Process Development
api-v2/bpmn/index.md -- Camunda statt Operaton:
"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:
"ServiceTask is the interface to be implemented for ... Task Listener"-- sollte"UserTaskListener"heissen, nicht"ServiceTask".api-v2/bpmn/execution-listeners.md -- Abgebrochener Inhalt:
"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.mdZeile 61:src/main/resources/fhir/CodeSystem-- solltefhir/ValueSetsein.api-v2/guides/creating-valuesets-for-dsf-processes.mdZeile 62: Gleicher Fehler.api-v2 Seiten die unveraenderte v1-Kopien sind:
fhir/valueset.md-- identisch mit v1, verlinkt noch aufmain-Branch stattrelease/2.0.2fhir/questionnaire-and-questionnaireresponse.md-- identisch mit v1bpmn/sequence-flow.md-- identischbpmn/conditions.md-- weitgehend identisch15. Duplizierter Inhalt
explore/concepts/README.mdfor-you/index.mdfor-you/index.mdhat zusaetzlich einen Meta-Redirect.hackathon/index.mdhackathon/hackathon-2026.mdindex.mdhat zusaetzlich Auto-Redirect zum Konferenzraum.explore/README.md16. Sicherheitsbedenken
OIDC-Beispiele enthalten Inline-Secrets:
bpe/oidc.mdZeile 51 undfhir/oidc.mdZeile 58:DEV_DSF_SERVER_AUTH_OIDC_CLIENT_SECRET: n9bCMtjugv3Y_.szktXyQ2RH5se+J%o3_FILE-Variante mit Docker Secrets. Widerspricht der empfohlenen Praxis auspasswords-secrets.md.17. Stilinkonsistenzen
17.1 Emoji-Nutzung
concepts/basics.md::fire:Emoji neben "HL7 FHIR"community/communication.md::rocket:Emojinews/fhir-devdays-2025/index.md: Mail-Emoji17.2 Terminologie
"organisation"vs."organization","centre"vs."center""whitelist"(security.md) vs."allow list"(allow-list.md)"highmed"in aelteren Tutorial-Seiten vs."datasharingframework"aktuell17.3 Auskommentierter Code
network-setup.mdZeilen 25-68: Grosser Block auskommentierter nginx/haproxy-Konfigurationprocess-plugins.mdZeilen 47-59: Auskommentierter Abschnitt mit"blablabla"Platzhaltertextoperations/v2.0.2/index.mdZeilen 18-23: Auskommentierte<releas-notes>-Komponente (mit Typo im Tag-Namen)bpe/fhir-client-connections.mdZeile 25:<!-- TODO default values -->-- offener Developer-TODO18. Fehlende kritische Inhalte
api-v2/migration.mdapi-v2/get-started.mdapi-v2/bpmn/user-tasks.md, v2 hat kein Pendant.operations/v2.0.2/index.mdupgrade-from-2.mdexistiert.Aktualisierte Zusammenfassung / Prioritaeten
Kritisch
1.5.2statt2.0.2) in OIDC-Beispielenapi-v2/bpmn/execution-listeners.md-- Inhalt endet mitten im Satzapi-v2/dsf/activities.md-- "ServiceTask" statt "UserTaskListener"operations/v2.0.2/install.mdapi-v2/bpmn/index.mdstatt OperatonCodeSystemstattValueSet)Hoch
root-certificates.md)Mittel
Niedrig
versiondeprecatedStatistiken (aktualisiert)