Pflege von Entwicklungsportal-Inhalten via Git
Warum?
Dieses Issue ist Teil von Epic #1020 (closed).
Um zukünftig eine kollaborative Pflege von Inhalten im Entwicklungsportal auch durch Dritte zu ermöglichen, sollen die Inhalte der /resources
-Seite nicht mehr wie bisher in Contentful gepflegt werden, sondern als Markdown-Files im Git-Repo des Entwicklungsportals selbst.
Relevante Links und Bemerkungen
- Vorbild ist z.B. die Seite von Code for Germany. Dort sind Projekte als Markdown-Files im Git-Repo abgelegt: Markdown sources | gerenderte Seite | template
- Dieses Issue stellt eine alternative Umsetzung zu #452 (closed) dar.
- https://nextjs.org/learn/basics/dynamic-routes/render-markdown
Akzeptanzkriterien
- Die bestehnden Inhalte sind von Contentful auf das neue System migriert.
- Markdown-Files sind in einem Content-Folder abgelegt.
- Beim Ändern der Markdown-Files wird das Entwicklungsportal automatisch mit den neuen Inhalten via CI deployed.
- Contentful wird nicht mehr genutzt.
- Die URLs der einzelnen Ressourcen bleiben unverändert bestehen (keine neuen Pfade).
-
Auf der-> #1067 (closed)/resources
-Unterseite findet sich ein Bearbeiten-Link, der auf die GitLab-WebIDE zeigt (analog zu den Docusaurus-Seiten).
Durchführungsplan (von Entwickler:in bei Umsetzungsplanung auszufüllen)
- ...
- ...
- ...
- Definition of Done wurde geprüft