Diese Seite enthält die Details zu einem Projekt für technische Angelegenheiten, das für die Google-Saison der Dokumente angenommen wurde.
Projektzusammenfassung
- Open-Source-Organisation:
- PostgreSQL
- Technischer Redakteur:
- lu
- Projektname:
- Einführung
- Projektdauer:
- Standardlänge (3 Monate)
Projektbeschreibung
Einführungsleitfaden aktualisiert, um die Installation und Einrichtung von PostgreSQL für Anfänger zu verbessern. (https://www.postgresql.org/docs/current/tutorial-start.html)
Das Kapitel zu architektonischen Grundlagen in eine umfassende Einführung in PostgreSQL-Tutorials umwandeln (https://www.postgresql.org/docs/current/tutorial-arch.html). Mögliche Themen sind die Client-Server-Architektur, psql als Clientbeispiel in diesem Tutorial, die Terminologie „Cluster“ im PostgreSQL-Kontext, Datenbank- und Betriebssystemnutzer sowie Inhaberschaft.
Anleitung zur Aktualisierung der Installation (https://www.postgresql.org/docs/current/tutorial-install.html)
- Bieten Sie sowohl Quell- als auch Binärinstallationsoptionen an. Fügen Sie einen Verweis auf https://www.postgresql.org/download/ hinzu, wo eine Anleitung zur Installation der Minimal-Binärdatei verfügbar ist.
- Ermitteln Sie eventuelle Lücken in der Anleitung zur Installation von Binärdateien und erweitern Sie die Website oder gehen Sie in der Dokumentation darauf ein.
- Sie sollten nicht davon ausgehen, dass Nutzer das gesamte Kapitel zur Installation aus der Quelle lesen und es selbst herausfinden. Skizzieren Sie die wichtigsten Schritte nach der Installation, z. B. die Initialisierung des Clusters und den (automatischen) Start des Servers. Geben Sie gegebenenfalls Links zu bestimmten Kapiteln der Dokumentation an, um weitere Informationen zu erhalten.
- Fügen Sie Links zu relevanten Ressourcen hinzu, in denen Standardeinstellungen und Best Practices für ein bestimmtes Betriebssystem erläutert werden, sofern solche von der Community anerkannt sind.
Verbessern https://www.postgresql.org/docs/current/tutorial-createdb.html
- Entfernen Sie nach Möglichkeit die Anweisungen „Wenden Sie sich an den Administrator“. Bieten Sie umsetzbare Lösungen unter der Annahme an, dass der Nutzer die Anleitung Schritt für Schritt befolgt hat.
Verbessern https://www.postgresql.org/docs/current/tutorial-accessdb.html
- Grundlegende Probleme im Zusammenhang mit der Authentifizierung und einfache pg_hba.conf-Beispiele erläutern
Um diesen Dokumentations-Patch bereitzustellen, werde ich die aktuelle Anleitung unter Windows und Ubuntu ausprobieren, in Foren nach häufigen Einrichtungsproblemen suchen und Mentoren konsultieren, um sicherzustellen, dass ich die Best Practices richtig anwende und die wichtigsten Konzepte ohne Übervereinfachung erkläre.