PostgreSQL 專案

本頁針對 Google 系列文件接受的技術撰寫專案提供詳細資料。

專案摘要

開放原始碼機構：
PostgreSQL
技術文件撰寫者：
lu
專案名稱：
入門教學課程
專案長度：
標準長度 (3 個月)

Project description

更新入門教學課程，為新手改善 PostgreSQL 安裝和設定體驗。(https://www.postgresql.org/docs/current/tutorial-start.html)

  1. 將「架構基礎知識」章節轉換為完整的 PostgreSQL 教學課程簡介 (https://www.postgresql.org/docs/current/tutorial-arch.html)。其他可能的要點包括：用戶端與伺服器架構、psql 做為本教學課程的用戶端範例、PostgreSQL 環境中的「叢集」術語、DB 與 OS 使用者和 OS 的擁有權。

  2. 更新安裝教學課程 (https://www.postgresql.org/docs/current/tutorial-install.html)。

    • 同時通告來源和二進位檔安裝選項。將參考資料新增至 https://www.postgresql.org/download/，提供最低的二進位檔安裝操作說明。
    • 找出二進位安裝操作說明的缺口 (如果有的話)，然後擴充網站或說明文件中的問題。
    • 請勿仰賴使用者閱讀完整來源安裝章節並進行說明：列出安裝後需要的主要步驟，例如將叢集初始化以及 (自動) 啟動伺服器。提供特定「說明文件」章節的連結，以提供更多詳細資料 (如適用)。
    • 在社群中找到任何認證時，也可以加入相關資源的連結，進一步瞭解特定 OS 的預設和最佳做法。

  3. 改善 https://www.postgresql.org/docs/current/tutorial-createdb.html

    • 請盡量刪除「諮詢管理員」操作說明，並假設使用者按照教學課程逐步進行，提供實用的解決方案。

  4. 改善 https://www.postgresql.org/docs/current/tutorial-accessdb.html

    • 說明與驗證和複雜 pg_hba.conf 範例相關的基本問題

如要提供這份說明文件修補程式，我打算嘗試 Windows 和 Ubuntu 目前的教學課程、瀏覽常見設定問題的論壇，以及諮詢顧問，確保我能取得正確的最佳做法，並瞭解最重要的概念，不會過度簡化。