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 上试用当前的教程、浏览论坛以查找常见设置问题，并咨询导师以确保我遵循最佳实践，并且不会过度简化，并且能够解释最重要的概念。