Ta strona zawiera szczegóły projektu technicznego do pisania 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
Zaktualizowaliśmy samouczek wprowadzający, aby ułatwić instalację i konfigurację PostgreSQL początkującym. (https://www.postgresql.org/docs/current/tutorial-start.html)
Przekształcić rozdział Architektura podstawowa w obszerny wstęp do samouczników PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html). Możliwe tematy do rozwinięcia to architektura klient-serwer, psql jako przykład klienta używanego w tym samouczku, terminologia „klaster” w kontekście PostgreSQL, użytkownicy i własność bazy danych w porównaniu z użytkownikami i własnością systemu operacyjnego.
Aktualizacja samouczka instalacji (https://www.postgresql.org/docs/current/tutorial-install.html).
- Reklamuj opcje instalacji zarówno źródła, jak i binarnego. Dodaj link do strony https://www.postgresql.org/download/, na której znajdziesz instrukcje instalacji minimalnej wersji binarnej.
- Określ luki w instrukcjach instalacji binarnych (jeśli występują) i rozszerz stronę internetową lub omów je w dokumentacji.
- Nie zakładaj, że użytkownicy przeczytają cały rozdział dotyczący instalacji źródłowej i sami się tego nauczą. Wymień główne kroki wymagane po instalacji, takie jak inicjowanie klastra i (automatyczne) uruchamianie serwera. W razie potrzeby podaj linki do konkretnych rozdziałów dokumentacji, aby uzyskać więcej informacji.
- Dodaj linki do odpowiednich materiałów, które zawierają informacje o domyślnych ustawieniach i sprawdzonych metodach dotyczących konkretnego systemu operacyjnego (jeśli są one rozpoznawane przez społeczność).
Ulepszanie https://www.postgresql.org/docs/current/tutorial-createdb.html
- W miarę możliwości usuń instrukcje „skontaktuj się z administratorem” i podaj praktyczne rozwiązania oparte na założeniu, że użytkownik postępował zgodnie z instrukcjami.
Ulepszanie https://www.postgresql.org/docs/current/tutorial-accessdb.html
- Wyjaśnienie podstawowych problemów związanych z uwierzytelnianiem i przykładami pliku pg_hba.conf
Aby przygotować tę poprawkę dokumentacji, zamierzam wypróbować obecny samouczek dotyczący Windows i Ubuntu, przejrzeć fora w celu znalezienia najczęstszych problemów z konfiguracją i skonsultować się z mentorami, aby upewnić się, że sprawdzone metody są prawidłowe, a najważniejsze pojęcia są wyjaśnione bez nadmiernego uproszczenia.