Projekt PostgreSQL
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eThis project aims to update the PostgreSQL introductory tutorial, focusing on improving the installation and setup process for beginners.\u003c/p\u003e\n"],["\u003cp\u003eThe project will revamp the tutorial's structure, providing a comprehensive introduction to PostgreSQL concepts like client-server architecture and database clusters.\u003c/p\u003e\n"],["\u003cp\u003eInstallation instructions will be enhanced to cover both source and binary options, addressing common setup challenges faced by new users.\u003c/p\u003e\n"],["\u003cp\u003eThe tutorial will empower users to independently create and access databases, simplifying instructions and providing solutions for typical authentication issues.\u003c/p\u003e\n"],["\u003cp\u003eThe project involves practical testing, community feedback analysis, and expert consultation to ensure clarity, accuracy, and relevance of the updated tutorial.\u003c/p\u003e\n"]]],["The project involves updating the PostgreSQL introductory tutorial for beginners. Key actions include converting the Architectural Fundamentals chapter into a comprehensive introduction, updating the Installation tutorial to cover both source and binary options, and outlining post-installation steps like initializing the cluster and starting the server. It also involves improving the create and access database tutorials by providing actionable solutions and explaining authentication basics, while aiming to minimize reliance on administrator consultation. The writer will test the tutorial on Windows and Ubuntu, and consult mentors.\n"],null,["# PostgreSQL project\n\nThis page contains the details of a technical writing project accepted for\nGoogle Season of Docs.\n\nProject summary\n---------------\n\nOpen source organization:\n: PostgreSQL\n\nTechnical writer:\n: lu\n\nProject name:\n: Introductory Tutorial\n\nProject length:\n: Standard length (3 months)\n\nProject description\n-------------------\n\nUpdate introductory tutorial to improve PostgreSQL installation and setup experience for beginners.\n(\u003chttps://www.postgresql.org/docs/current/tutorial-start.html\u003e)\n\n1. Convert the Architectural Fundamentals chapter into a comprehensive introduction to PostgreSQL tutorials (\u003chttps://www.postgresql.org/docs/current/tutorial-arch.html\u003e). Possible things to expand on are client-server architecture, psql as a client example to be used in this tutorial, \"\"cluster\"\" terminology in PostgreSQL context, DB vs OS users and ownership.\n\n2. Update Installation tutorial (\u003chttps://www.postgresql.org/docs/current/tutorial-install.html\u003e).\n\n - Advertise both source and binary install options. Add reference to \u003chttps://www.postgresql.org/download/\u003e that offers minimal binary install instructions.\n - Identify gaps in binary install instructions, if any, and either expand the website or address them in documentation.\n - Do not rely on users reading the full source-install chapter and figuring it out: outline the main steps required after the install, such as initializing the cluster and (auto)starting the server. Provide links to specific Documentation chapters for more details where applicable.\n - Add see-also links to relevant resources that expand on defaults and best practices for a particular OS, if there are any recognized by the community.\n3. Improve \u003chttps://www.postgresql.org/docs/current/tutorial-createdb.html\u003e\n\n - Get rid of \"\"consult the administrator\"\" instructions wherever possible; provide actionable solutions based on the assumption that the user followed the tutorial step-by-step.\n4. Improve \u003chttps://www.postgresql.org/docs/current/tutorial-accessdb.html\u003e\n\n - Explain basic issues related to authentication and trivial pg_hba.conf examples\n\nTo provide this documentation patch, I intend to try out the current tutorial on Windows and Ubuntu, browse forums for frequent setup issues, and consult mentors to ensure I get the best practices right and the most important concepts are explained without oversimplification."]]
