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 上的当前教程，浏览论坛以了解常见设置问题，并咨询导师，确保我掌握了正确的最佳实践，并避免过度简化地解释最重要的概念。