From d39b12afac6e58f0298719070c15bbee72715d8c Mon Sep 17 00:00:00 2001 From: Nick Slowinski Date: Thu, 9 May 2024 15:29:22 +0200 Subject: [PATCH] Restructuring of services Signed-off-by: Nick Slowinski --- services/communication/_category_.yml | 1 - services/{ => communication}/community.md | 0 services/data/_category_.yml | 3 +- services/{ => data}/pw-manager.md | 0 services/development/_category_.yml | 2 +- services/hosting/_category_.yml | 9 ++++ services/{ => hosting}/amp.md | 0 services/{ => hosting}/monitoring.md | 0 services/{ => hosting}/sso/_category_.yml | 0 services/{ => hosting}/sso/intro.md | 0 services/intro.md | 62 ----------------------- services/privacy/_category_.yml | 9 ++++ services/{ => privacy}/adguard.md | 0 services/{ => privacy}/vpn.md | 0 services/support-tickets.md | 2 +- 15 files changed, 21 insertions(+), 67 deletions(-) rename services/{ => communication}/community.md (100%) rename services/{ => data}/pw-manager.md (100%) create mode 100644 services/hosting/_category_.yml rename services/{ => hosting}/amp.md (100%) rename services/{ => hosting}/monitoring.md (100%) rename services/{ => hosting}/sso/_category_.yml (100%) rename services/{ => hosting}/sso/intro.md (100%) delete mode 100644 services/intro.md create mode 100644 services/privacy/_category_.yml rename services/{ => privacy}/adguard.md (100%) rename services/{ => privacy}/vpn.md (100%) diff --git a/services/communication/_category_.yml b/services/communication/_category_.yml index de171ca..66afeaf 100644 --- a/services/communication/_category_.yml +++ b/services/communication/_category_.yml @@ -6,5 +6,4 @@ className: red link: type: generated-index title: Kommunikation - description: . slug: /kommunikation \ No newline at end of file diff --git a/services/community.md b/services/communication/community.md similarity index 100% rename from services/community.md rename to services/communication/community.md diff --git a/services/data/_category_.yml b/services/data/_category_.yml index 05d7fb4..a5ad992 100644 --- a/services/data/_category_.yml +++ b/services/data/_category_.yml @@ -1,4 +1,4 @@ -position: 4 # float position is supported +position: 1 # float position is supported label: 'Daten' collapsible: true # make the category collapsible collapsed: false # keep the category open by default @@ -6,5 +6,4 @@ className: red link: type: generated-index title: Daten - description: . slug: /daten \ No newline at end of file diff --git a/services/pw-manager.md b/services/data/pw-manager.md similarity index 100% rename from services/pw-manager.md rename to services/data/pw-manager.md diff --git a/services/development/_category_.yml b/services/development/_category_.yml index ab9eeba..65699d4 100644 --- a/services/development/_category_.yml +++ b/services/development/_category_.yml @@ -1,4 +1,4 @@ -position: 4 # float position is supported +position: 2 # float position is supported label: 'Entwicklung' collapsible: true # make the category collapsible collapsed: false # keep the category open by default diff --git a/services/hosting/_category_.yml b/services/hosting/_category_.yml new file mode 100644 index 0000000..b3d3c7c --- /dev/null +++ b/services/hosting/_category_.yml @@ -0,0 +1,9 @@ +position: 3 # float position is supported +label: 'Hosting' +collapsible: true # make the category collapsible +collapsed: false # keep the category open by default +className: red +link: + type: generated-index + title: Hosting + slug: /hosting \ No newline at end of file diff --git a/services/amp.md b/services/hosting/amp.md similarity index 100% rename from services/amp.md rename to services/hosting/amp.md diff --git a/services/monitoring.md b/services/hosting/monitoring.md similarity index 100% rename from services/monitoring.md rename to services/hosting/monitoring.md diff --git a/services/sso/_category_.yml b/services/hosting/sso/_category_.yml similarity index 100% rename from services/sso/_category_.yml rename to services/hosting/sso/_category_.yml diff --git a/services/sso/intro.md b/services/hosting/sso/intro.md similarity index 100% rename from services/sso/intro.md rename to services/hosting/sso/intro.md diff --git a/services/intro.md b/services/intro.md deleted file mode 100644 index dc9576f..0000000 --- a/services/intro.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -sidebar_position: 1 - ---- - -# Einleitung - -Willkommen zur Dokumentation von nick-slowinski.de. - -Wir hoffen, dass diese Dokumentation ein guter Einstieg bei Fragen und Problemen ist. Solltest du dennoch eine Frage oder ein Anliegen haben, [kontaktiere uns einfach](/kontakt). - -## Inhalte beitragen - -Diese Dokumentation ist noch relativ neu und weist daher auch Lücken auf, jeder ist eingeladen an dieser Dokumentation mit zu wirken. - -Der Quellcode dieser Dokumentation wird in meiner [Forge](https://forge.nick-slowinski.de/nick-slowinski.de/docs) verwaltet, ein [Konto](/kontoverwaltung) wird benötigt um Inhalte zu verfassen. - -### Fehler melden - -Um Fehler jeglicher Art zu melden kann ein Ticket im [Issuetracker](https://forge.nick-slowinski.de/nick-slowinski.de/docs/issues) meiner Forge erstellt werden. Bitte durchsucht den Issuetracker vor der Erstellung eines Tickets, um eine doppelte Meldung zu vermeiden. Dies ist die bevorzugte Variante der Fehlermeldung um eine schnelle Behebung und korrekte Anerkennung aller beteiligten Parteien zu gewährleisten. - -Natürlich können Fehler ebenfalls über andere Kontaktwege gemeldet werden, allerdings kann es dabei zu einer langsamen Bearbeitung und fehlende Anerkennung kommen. - -**Optional:** Wir sind natürlich sehr dankbar, wenn der/die Fehler(r) direkt von dir behoben wird. Lese bitte die folgenden Abschnitte um zu erfahren, wie du dies bewerkstelligen kannst. - -### Inhalte verbessern - -#### Inhalte schreiben - -Inhalte die dringend eine Überarbeitung benötigen sind mit dem Tag [*"Hilfe benötigt!"*](/tags/hilfe-benotigt) gekennzeichnet, andere Beiträge sind unter Umständen ebenfalls verbesserungswürdig. - -##### Bearbeitung in der Forge (für Anfänger geeignet) - -1. Besuche die Forge, und [forke das Repository](https://forge.nick-slowinski.de/repo/fork/37). -2. Öffne den Fork und suche die entsprechende Datei die du bearbeiten möchtest. -3. Bearbeite die entsprechenden Stellen, indem du auf den Stift (oben rechts, unterhalb von *"Einstellungen"*) drückst. -4. Fülle die Commit-Infos aus und wähle *"Direkt in den Branch 'main' einchecken."* aus. Speichere deine Änderungen mit *"Änderungen committen"*. -5. Bei deinem ersten Beitrag: Füge deinen Namen in der Dateien `/docs/contributors.md` am Ende ein, verlinke dabei auf das Profil in der Forge. Beachte dabei die bestehende Formatierung. -6. Wenn du alle Dateien bearbeitet hast, kehre zum offiziellen Repository der Dokumentation zurück und [starte einen neuen Pull-Request](https://forge.nick-slowinski.de/nick-slowinski.de/docs/compare/main...main), wähle als Ziel `nick-slowinski.de:main` und als Quelle deine bearbeitete Branch aus deinem Repository (oftmals `:main`) -7. Kontrolliere deine Änderungen und ergänze wichtige Informationen, erkläre dabei was du mit deinen Änderungen bezwecken möchtest. Wenn alles stimmt, starte den Pull-Request indem du auf *"Pull-Request erstellen"* drückst. -8. Frage Sie eine Review von *"nick-slowinski.de/Owners"* an, indem du in der rechten Spalte auf das Zahnrad neben *"Reviewer"* drückst. -9. Mindestens ein Reviewer wird sich deine Änderungen zeitnah anschauen und Feedback geben und wenn alles in Ordnung ist, deine Änderungen mergen. - -##### Bearbeitung über Git (führ erfahrene Nutzer) - -1. Besuche die Forge, und [forke das Repository](https://forge.nick-slowinski.de/repo/fork/37). -2. Clone deinen Fork auf deinen Computer -3. Bearbeite die entsprechenden Dateien und committe deine Änderungen. -4. Pushe deine Commits in deinen Fork. -5. Bei deinem ersten Beitrag: Füge deinen Namen in der Dateien `/docs/contributors.md` am Ende ein, verlinke dabei auf das Profil in der Forge. Beachte dabei die bestehende Formatierung. -6. Wenn du alle Dateien bearbeitet hast, kehre zum offiziellen Repository der Dokumentation zurück und [starte einen neuen Pull-Request](https://forge.nick-slowinski.de/nick-slowinski.de/docs/compare/main...main), wähle als Ziel `nick-slowinski.de:main` und als Quelle deine bearbeitete Branch aus deinem Repository (oftmals `:main`) -7. Kontrolliere deine Änderungen und ergänze wichtige Informationen, erkläre dabei was du mit deinen Änderungen bezwecken möchtest. Wenn alles stimmt, starte den Pull-Request indem du auf *"Pull-Request erstellen"* drückst. -8. Frage Sie eine Review von *"nick-slowinski.de/Owners"* an, indem du in der rechten Spalte auf das Zahnrad neben *"Reviewer"* drückst. -9. Mindestens ein Reviewer wird sich deine Änderungen zeitnah anschauen und Feedback geben und wenn alles in Ordnung ist, deine Änderungen mergen. - -#### Inhalte übersetzen - -Die Mehrsprachigkeit ist momentan noch nicht eingerichtet, jedoch soll die Dokumentation (in Teilen) auch auf Englisch verfügbar sein. Andere Sprachen können mit Hilfe der Community ebenfalls bereitgestellt werden, jedoch dann ohne offiziellen Support. - -Bis zur Einrichtung der Mehrsprachigkeit soll das Repository einfach geforkt werden und unterhalb der deutschen Version jeweils die englische Übersetzung angehängt werden. Sobald jemand an einer Übersetzung arbeiten möchte, kann die betreffende Person gerne ein Issue erstellen und mich auf seine/ihre Absichten aufklären. Es wird dann zeitnah mit der Einrichtung der Mehrsprachigkeit begonnen. - -Alternativ kann natürlich selbstständig mit der Einrichtung der Mehrsprachigkeit begonnen werden. Beachtet dabei die [offizielle Dokumentation von Docusaurus](https://docusaurus.io/docs/i18n/introduction). \ No newline at end of file diff --git a/services/privacy/_category_.yml b/services/privacy/_category_.yml new file mode 100644 index 0000000..1a8f5f3 --- /dev/null +++ b/services/privacy/_category_.yml @@ -0,0 +1,9 @@ +position: 5 # float position is supported +label: 'Privatsphäre' +collapsible: true # make the category collapsible +collapsed: false # keep the category open by default +className: red +link: + type: generated-index + title: Privatsphäre + slug: /privatsphäre \ No newline at end of file diff --git a/services/adguard.md b/services/privacy/adguard.md similarity index 100% rename from services/adguard.md rename to services/privacy/adguard.md diff --git a/services/vpn.md b/services/privacy/vpn.md similarity index 100% rename from services/vpn.md rename to services/privacy/vpn.md diff --git a/services/support-tickets.md b/services/support-tickets.md index 3513dc6..e40c6cb 100644 --- a/services/support-tickets.md +++ b/services/support-tickets.md @@ -1,5 +1,5 @@ --- -sidebar_position: 14.5 +sidebar_position: 6 description: Der Service ist noch in der Einrichtungsphase und nicht öffentlich verfügbar. tags: - Zukünftige Dienste