Improve intro

2023-09-10 15:10:42 +02:00 · 2023-09-10 15:10:42 +02:00 · 10d7e84d8d
Commit 10d7e84d8d
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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.
+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 `<dein Benutzername>: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 `<dein Benutzername>: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).
--- 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
--- 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)
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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)
--- 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
--- 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
--- 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