Dự án PostgreSQL
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này chứa thông tin chi tiết về một dự án viết nội dung kỹ thuật đã được chấp nhận tham gia Google Season of Docs.
Tóm tắt dự án
- Tổ chức nguồn mở:
- PostgreSQL
- Người viết nội dung kỹ thuật:
- lu
- Tên dự án:
- Hướng dẫn nhập môn
- Thời lượng dự án:
- Thời gian tiêu chuẩn (3 tháng)
Mô tả dự án
Cập nhật hướng dẫn nhập môn để cải thiện trải nghiệm cài đặt và thiết lập PostgreSQL cho người mới bắt đầu.
(https://www.postgresql.org/docs/current/tutorial-start.html)
Chuyển chương "Kiến thức cơ bản về kiến trúc" thành phần giới thiệu toàn diện về các hướng dẫn về PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html). Bạn có thể mở rộng kiến trúc máy khách-máy chủ, psql làm ví dụ về máy khách sẽ được sử dụng trong hướng dẫn này, thuật ngữ ""cluster"" trong ngữ cảnh PostgreSQL, quyền sở hữu và người dùng DB so với OS.
Cập nhật hướng dẫn cài đặt (https://www.postgresql.org/docs/current/tutorial-install.html).
- Quảng cáo cả lựa chọn cài đặt nguồn và nhị phân. Thêm tệp tham chiếu đến https://www.postgresql.org/download/ để cung cấp hướng dẫn cài đặt tệp nhị phân tối thiểu.
- Xác định các thiếu sót trong hướng dẫn cài đặt tệp nhị phân (nếu có) và mở rộng trang web hoặc giải quyết các thiếu sót đó trong tài liệu.
- Đừng dựa vào việc người dùng đọc toàn bộ chương cài đặt nguồn và tìm hiểu điều đó: hãy nêu các bước chính cần thiết sau khi cài đặt, chẳng hạn như khởi chạy cụm và khởi động (tự động) máy chủ. Cung cấp đường liên kết đến các chương cụ thể trong Tài liệu để biết thêm thông tin chi tiết (nếu có).
- Thêm đường liên kết xem thêm đến các tài nguyên liên quan mở rộng về các phương pháp mặc định và phương pháp hay nhất cho một hệ điều hành cụ thể (nếu có tài nguyên nào được cộng đồng công nhận).
Cải thiện https://www.postgresql.org/docs/current/tutorial-createdb.html
- Loại bỏ hướng dẫn ""tham khảo ý kiến quản trị viên"" bất cứ khi nào có thể; cung cấp các giải pháp hữu ích dựa trên giả định rằng người dùng đã làm theo hướng dẫn từng bước.
Cải thiện https://www.postgresql.org/docs/current/tutorial-accessdb.html
- Giải thích các vấn đề cơ bản liên quan đến việc xác thực và các ví dụ về pg_hba.conf không quan trọng
Để cung cấp bản vá tài liệu này, tôi dự định thử hướng dẫn hiện tại trên Windows và Ubuntu, duyệt qua các diễn đàn để biết các vấn đề thường gặp về việc thiết lập và tham khảo ý kiến của các cố vấn để đảm bảo tôi nắm được các phương pháp hay nhất và giải thích các khái niệm quan trọng nhất mà không đơn giản hoá quá mức.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
