Ta strona zawiera szczegółowe informacje na temat projektu technicznego przyjęta do programu Sezon Dokumentów Google.
Podsumowanie projektu
- Organizacja open source:
- PostgreSQL
- Pisarz techniczny:
- lu
- Nazwa projektu:
- Samouczek dla początkujących
- Długość projektu:
- Standardowa długość (3 miesiące)
Opis projektu
Zaktualizuj samouczek wprowadzający, aby usprawnić instalację i konfigurację PostgreSQL dla początkujących. (https://www.postgresql.org/docs/current/tutorial-start.html)
Zamień rozdział Podstawy architektury na kompleksowe wprowadzenie do samouczków dotyczących PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html). Można rozwinąć architekturę klient-serwer, psql jako przykład klienta do zastosowania w tym samouczku, terminologię „klaster” w kontekście PostgreSQL, określić użytkowników bazy danych i systemu operacyjnego oraz własność.
Zaktualizuj samouczek instalacji (https://www.postgresql.org/docs/current/tutorial-install.html).
- Reklamuj opcje instalacji źródłowej i binarnej. Dodaj odniesienie do strony https://www.postgresql.org/download/, na której znajdziesz minimalną ilość instrukcji instalacji plików binarnych.
- Zidentyfikuj luki w instrukcjach instalacji plików binarnych (jeśli takie istnieją) i rozbuduj witrynę lub popraw je w dokumentacji.
- Nie czekaj, aż użytkownicy przeczytają rozdział całej instalacji źródłowej i go znajdą. Przedstaw główne czynności wymagane po instalacji, takie jak zainicjowanie klastra i (automatyczne) uruchomienie serwera. W razie potrzeby podaj linki do konkretnych rozdziałów dokumentacji, aby uzyskać więcej szczegółów.
- Dodaj też linki do stron z opisem ustawień domyślnych i sprawdzonych metod dotyczących konkretnego systemu operacyjnego, jeśli są one uznawane przez społeczność.
Ulepszenie https://www.postgresql.org/docs/current/tutorial-createdb.html
- W miarę możliwości pozbądź się instrukcji związanych z „konsultacjami z administratorem” i zaproponuj przydatne rozwiązania oparte na założeniu, że użytkownik wykonał poszczególne czynności z samouczka.
Ulepsz stronę https://www.postgresql.org/docs/current/tutorial-accessdb.html
- Wyjaśnij podstawowe problemy związane z uwierzytelnianiem i proste przykłady pliku pg_hba.conf
W związku z tą poprawką dokumentacji zamierzam wypróbować obecny samouczek dotyczący systemów Windows i Ubuntu, przejrzeć fora, w których znajdują się częste problemy z konfiguracją, i skonsultować się z mentorami, aby mieć pewność, że wykorzystywam sprawdzone metody, a najważniejsze pojęcia są wyjaśnione bez nadmiernego uproszczenia.