Ta strona zawiera szczegółowe informacje na temat projektu dotyczącego pisania technicznego zaakceptowanego do udziału w sezonie Dokumentów Google.
Podsumowanie projektu
- Organizacja open source:
- PostgreSQL
- Pisarz techniczny:
- lu
- Nazwa projektu:
- Samouczek wprowadzający
- 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)
Przekształć rozdział Podstawy architektury w kompleksowe wprowadzenie do samouczków dotyczących PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html). Można rozszerzyć architekturę klient-serwer, psql jako przykład klienta używanego w tym samouczku, terminologię „klaster” w kontekście PostgreSQL, użytkowników bazy danych w porównaniu z użytkownikami systemu operacyjnego oraz własność.
Zaktualizuj samouczek instalacji (https://www.postgresql.org/docs/current/tutorial-install.html).
- Reklamuj opcje instalacji zarówno źródłowe, jak i binarne. Dodaj odniesienie do strony https://www.postgresql.org/download/, na której znajduje się minimalna instrukcja instalacji plików binarnych.
- Zidentyfikuj luki w instrukcjach instalacji plików binarnych (jeśli takie istnieją) i rozwiń witrynę lub uzupełnij je w dokumentacji.
- Nie czekaj, aż użytkownicy przeczytają rozdział całej instalacji źródłowej i zapoznali się z nim: wymień główne czynności, które trzeba wykonać po instalacji, takie jak zainicjowanie klastra i (automatyczne) uruchomienie serwera. Jeśli to możliwe, podaj linki do konkretnych rozdziałów dokumentacji.
- Dodaj też linki do odpowiednich materiałów opisujących ustawienia domyślne i sprawdzone metody dotyczące konkretnego systemu operacyjnego, jeśli takie istnieją.
Popraw https://www.postgresql.org/docs/current/tutorial-createdb.html
- W miarę możliwości pozbądź się instrukcji związanych z „konsultacjami z administratorem”. Przedstaw przydatne rozwiązania w oparciu o założenie, że użytkownik postępuje zgodnie z instrukcjami w samouczku.
Popraw https://www.postgresql.org/docs/current/tutorial-accessdb.html
- Wyjaśnij podstawowe problemy związane z uwierzytelnianiem i proste przykłady pg_hba.conf
Aby udostępnić tę poprawkę dokumentacji, zamierzam wypróbować obecny samouczek w systemach Windows i Ubuntu, przejrzeć fora w poszukiwaniu częstych problemów z konfiguracją i skonsultować się z mentorami, aby mieć pewność, że potrafię prawidłowo stosować sprawdzone metody i wyjaśniać najważniejsze pojęcia bez zbytnich uproszczeń.