From 10d7e84d8dc1cfb09418307244fb8c00540e9f7c Mon Sep 17 00:00:00 2001 From: Nick Slowinski Date: Sun, 10 Sep 2023 15:10:42 +0200 Subject: [PATCH] Improve intro --- docs/accounts.md | 2 ++ docs/hosting/discourse.md | 2 ++ docs/hosting/gameserver.md | 2 ++ docs/hosting/others.md | 2 ++ docs/hosting/sso.md | 2 ++ docs/infra/overview.md | 2 ++ docs/intro.md | 60 ++++++++++++++++++++++++++++---- docs/services/adguard.md | 2 ++ docs/services/ci-cd.md | 2 ++ docs/services/cloud.md | 2 ++ docs/services/community.md | 2 ++ docs/services/dbms.md | 2 ++ docs/services/download-portal.md | 2 ++ docs/services/e-mail/intro.md | 2 ++ docs/services/forge.md | 2 ++ docs/services/monitoring.md | 2 ++ docs/services/pw-manager.md | 2 ++ docs/services/s3.md | 2 ++ docs/services/sso/intro.md | 2 ++ docs/services/translate.md | 2 ++ docs/services/vpn.md | 2 ++ 21 files changed, 93 insertions(+), 7 deletions(-) diff --git a/docs/accounts.md b/docs/accounts.md index 217ebe7..a1d427b 100644 --- a/docs/accounts.md +++ b/docs/accounts.md @@ -2,6 +2,8 @@ sidebar_position: 2 description: Ein Konto für alle Dienste - Schluss mit mehreren Logins für ein System. slug: kontoverwaltung +tags: + - Hilfe benötigt! --- # Kontoverwaltung diff --git a/docs/hosting/discourse.md b/docs/hosting/discourse.md index e0577fe..03317de 100644 --- a/docs/hosting/discourse.md +++ b/docs/hosting/discourse.md @@ -1,6 +1,8 @@ --- sidebar_position: 1 description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Hilfe benötigt! --- # Discourse Hosting diff --git a/docs/hosting/gameserver.md b/docs/hosting/gameserver.md index 0e83e3c..6118ef0 100644 --- a/docs/hosting/gameserver.md +++ b/docs/hosting/gameserver.md @@ -1,6 +1,8 @@ --- sidebar_position: 2 description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Zukünftige Dienste --- # Spieleserver diff --git a/docs/hosting/others.md b/docs/hosting/others.md index dfc0cb0..41b1a25 100644 --- a/docs/hosting/others.md +++ b/docs/hosting/others.md @@ -1,6 +1,8 @@ --- sidebar_position: 3 description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Hilfe benötigt! --- # Anderes diff --git a/docs/hosting/sso.md b/docs/hosting/sso.md index 7a128c2..866c454 100644 --- a/docs/hosting/sso.md +++ b/docs/hosting/sso.md @@ -1,5 +1,7 @@ --- description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Zukünftige Dienste --- # Single Sign-on diff --git a/docs/infra/overview.md b/docs/infra/overview.md index 6856676..906bba3 100644 --- a/docs/infra/overview.md +++ b/docs/infra/overview.md @@ -1,6 +1,8 @@ --- sidebar_position: 1 description: Erlangen Sie einen Überblick über usnere Infrastruktur. +tags: + - Hilfe benötigt! --- # Übersicht diff --git a/docs/intro.md b/docs/intro.md index d6debf3..fd4b159 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -5,12 +5,58 @@ slug: / # Einleitung -:::note - -Diese Dokumentation befindet sich noch im Aufbau und wird nach für nach vervollständigt. - -::: - 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. \ No newline at end of file +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/docs/services/adguard.md b/docs/services/adguard.md index 751ec52..879f5cd 100644 --- a/docs/services/adguard.md +++ b/docs/services/adguard.md @@ -1,6 +1,8 @@ --- sidebar_position: 1 description: Der Service ist noch in der Einrichtungsphase und nicht öffentlich verfügbar. +tags: + - Zukünftige Dienste --- # AdGuard diff --git a/docs/services/ci-cd.md b/docs/services/ci-cd.md index b29d9c0..4c52da3 100644 --- a/docs/services/ci-cd.md +++ b/docs/services/ci-cd.md @@ -2,6 +2,8 @@ sidebar_position: 2 description: Dieser Inhalt muss noch geschrieben werden. slug: drone +tags: + - Hilfe benötigt! --- # CI/CD (Drone) diff --git a/docs/services/cloud.md b/docs/services/cloud.md index e9ea6de..a6ad124 100644 --- a/docs/services/cloud.md +++ b/docs/services/cloud.md @@ -1,6 +1,8 @@ --- sidebar_position: 3 description: Dieser Service ist für die Zukunft geplant. +tags: + - Zukünftige Dienste --- # Cloud diff --git a/docs/services/community.md b/docs/services/community.md index cbd26d7..9bf2d8e 100644 --- a/docs/services/community.md +++ b/docs/services/community.md @@ -1,6 +1,8 @@ --- sidebar_position: 4 description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Hilfe benötigt! --- # Community Forum diff --git a/docs/services/dbms.md b/docs/services/dbms.md index f06e184..82564db 100644 --- a/docs/services/dbms.md +++ b/docs/services/dbms.md @@ -1,6 +1,8 @@ --- sidebar_position: 5 description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Hilfe benötigt! --- # Datenbankmanagmentsysteme diff --git a/docs/services/download-portal.md b/docs/services/download-portal.md index be9bd21..8f3dbf1 100644 --- a/docs/services/download-portal.md +++ b/docs/services/download-portal.md @@ -2,6 +2,8 @@ sidebar_position: 7 description: Dieser Inhalt muss noch geschrieben werden. slug: downloads +tags: + - Hilfe benötigt! --- # Download-Portal diff --git a/docs/services/e-mail/intro.md b/docs/services/e-mail/intro.md index b9f438e..790bd7c 100644 --- a/docs/services/e-mail/intro.md +++ b/docs/services/e-mail/intro.md @@ -1,5 +1,7 @@ --- description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Hilfe benötigt! --- # Einleitung diff --git a/docs/services/forge.md b/docs/services/forge.md index 0aca6c8..85f5b34 100644 --- a/docs/services/forge.md +++ b/docs/services/forge.md @@ -1,6 +1,8 @@ --- sidebar_position: 9 description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Hilfe benötigt! --- # Forge diff --git a/docs/services/monitoring.md b/docs/services/monitoring.md index c90201a..13485f9 100644 --- a/docs/services/monitoring.md +++ b/docs/services/monitoring.md @@ -1,6 +1,8 @@ --- sidebar_position: 10 description: Ist Service XYZ online? Schauen Sie einfach im Monitoring nach. +tags: + - Hilfe benötigt! --- # Monitoring diff --git a/docs/services/pw-manager.md b/docs/services/pw-manager.md index f535a1f..5a5bafe 100644 --- a/docs/services/pw-manager.md +++ b/docs/services/pw-manager.md @@ -1,6 +1,8 @@ --- sidebar_position: 11 description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Hilfe benötigt! --- # Passwort-Manager diff --git a/docs/services/s3.md b/docs/services/s3.md index 1968ef1..49fb90f 100644 --- a/docs/services/s3.md +++ b/docs/services/s3.md @@ -2,6 +2,8 @@ sidebar_position: 12 description: Dieser Inhalt muss noch geschrieben werden. slug: minio +tags: + - Hilfe benötigt! --- # S3-Speicher (Minio) diff --git a/docs/services/sso/intro.md b/docs/services/sso/intro.md index da70134..1ad9570 100644 --- a/docs/services/sso/intro.md +++ b/docs/services/sso/intro.md @@ -1,5 +1,7 @@ --- description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Zukünftige Dienste --- # Einleitung diff --git a/docs/services/translate.md b/docs/services/translate.md index f49cc31..09586ff 100644 --- a/docs/services/translate.md +++ b/docs/services/translate.md @@ -2,6 +2,8 @@ sidebar_position: 15 description: Der Service ist noch in der Einrichtungsphase und nicht öffentlich verfügbar. slug: übersetzungsplatform +tags: + - Zukünftige Dienste --- # Übersetzungsplatform diff --git a/docs/services/vpn.md b/docs/services/vpn.md index cd524e6..2e07ef4 100644 --- a/docs/services/vpn.md +++ b/docs/services/vpn.md @@ -1,6 +1,8 @@ --- sidebar_position: 16 description: Dieser Inhalt muss noch geschrieben werden. +tags: + - Hilfe benötigt! --- # VPN