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 情境中的「叢集」一詞，以及資料庫與作業系統使用者和擁有權。

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

   • 宣傳原始碼和二進位檔安裝選項。新增參照至 https://www.postgresql.org/download/，提供最少的二進位安裝說明。
   • 找出二進位安裝操作說明中的不足之處 (如果有的話)，然後展開網站或在說明文件中解決這些問題。
   • 不要讓使用者自行閱讀完整的來源安裝章節，請列出安裝後需要執行的主要步驟，例如初始化叢集和 (自動) 啟動伺服器。如果適用，請提供特定說明文件章節的連結，瞭解更多詳細資訊。
   • 新增相關資源的參考連結，進一步說明特定作業系統的預設值和最佳做法 (如果社群有認可的話)。

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 現有的教學課程、瀏覽論壇中常見的設定問題，並諮詢導師確保自己取得最佳做法，而且不會過度簡化重要概念。