โปรเจ็กต์ PostgreSQL
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
หน้านี้มีรายละเอียดของโปรเจ็กต์การเขียนเชิงเทคนิคที่ได้รับการยอมรับสำหรับ Google Season of Docs
สรุปโปรเจ็กต์
- องค์กรโอเพนซอร์ส:
- PostgreSQL
- นักเขียนเชิงเทคนิค
- lu
- ชื่อโปรเจ็กต์:
- บทแนะนำเบื้องต้น
- ความยาวของโปรเจ็กต์:
- ระยะเวลามาตรฐาน (3 เดือน)
คำอธิบายโปรเจ็กต์
อัปเดตบทแนะนำเบื้องต้นเพื่อปรับปรุงการติดตั้งและการตั้งค่า PostgreSQL สำหรับผู้เริ่มต้น
(https://www.postgresql.org/docs/current/tutorial-start.html)
แปลงบทพื้นฐานทางสถาปัตยกรรมให้เป็นบทนำที่ครอบคลุมเกี่ยวกับบทแนะนำ PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html) สิ่งที่อาจขยายความได้คือสถาปัตยกรรมไคลเอ็นต์-เซิร์ฟเวอร์, psql เป็นตัวอย่างไคลเอ็นต์ที่จะใช้ในบทแนะนำนี้, คำว่า ""คลัสเตอร์"" ในบริบท PostgreSQL, ผู้ใช้และกรรมสิทธิ์ของ DB เทียบกับ OS
อัปเดตบทแนะนำการติดตั้ง (https://www.postgresql.org/docs/current/tutorial-install.html)
- โฆษณาทั้งตัวเลือกการติดตั้งจากซอร์สโค้ดและไฟล์ไบนารี เพิ่มการอ้างอิงไปยัง https://www.postgresql.org/download/ ซึ่งมีวิธีการติดตั้งแบบไบนารีขั้นต่ำ
- ระบุช่องโหว่ในวิธีการติดตั้งแบบไบนารี (หากมี) และขยายเว็บไซต์หรือแก้ไขในเอกสารประกอบ
- อย่าคาดหวังให้ผู้ใช้อ่านบทการติดตั้งจากแหล่งที่มาฉบับเต็มและหาทางแก้ปัญหาเอง ให้ระบุขั้นตอนหลักที่จำเป็นหลังการติดตั้ง เช่น การจัดเตรียมคลัสเตอร์และเริ่มเซิร์ฟเวอร์ (โดยอัตโนมัติ) ระบุลิงก์ไปยังบทต่างๆ ของเอกสารประกอบเพื่อดูรายละเอียดเพิ่มเติม หากมี
- เพิ่มลิงก์ "ดูเพิ่มเติม" ไปยังแหล่งข้อมูลที่เกี่ยวข้องซึ่งขยายความเกี่ยวกับค่าเริ่มต้นและแนวทางปฏิบัติแนะนำสำหรับระบบปฏิบัติการหนึ่งๆ หากมีแหล่งข้อมูลที่ชุมชนยอมรับ
ปรับปรุง https://www.postgresql.org/docs/current/tutorial-createdb.html
- ลบวิธีการ "ปรึกษาผู้ดูแลระบบ" ออกเมื่อเป็นไปได้ ให้วิธีแก้ปัญหาที่ใช้งานได้โดยสมมติว่าผู้ใช้ทำตามบทแนะนำทีละขั้นตอน
ปรับปรุง https://www.postgresql.org/docs/current/tutorial-accessdb.html
- อธิบายปัญหาพื้นฐานที่เกี่ยวข้องกับการตรวจสอบสิทธิ์และตัวอย่าง pg_hba.conf ที่ไม่ซับซ้อน
ในการจัดทำเอกสารประกอบฉบับนี้ เราตั้งใจที่จะลองใช้บทแนะนำปัจจุบันใน Windows และ Ubuntu, เรียกดูฟอรัมเพื่อหาปัญหาการตั้งค่าที่พบบ่อย และปรึกษาที่ปรึกษาเพื่อให้แน่ใจว่าเราได้แนวทางปฏิบัติแนะนำที่ถูกต้องและอธิบายแนวคิดที่สำคัญที่สุดโดยไม่ทำให้เข้าใจง่ายจนเกินไป
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 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."]]
