Trang này chứa thông tin chi tiết về một dự án viết kỹ thuật được chấp nhận cho Google Phần Tài liệu.
Tóm tắt dự án
- Tổ chức nguồn mở:
- PostgreSQL
- Người viết nội dung kỹ thuật:
- :
- Tên dự án:
- Hướng dẫn cơ bản
- Thời lượng dự án:
- Thời lượng tiêu chuẩn (3 tháng)
Mô tả dự án
Cập nhật phần hướng dẫn nhập môn để cải thiện trải nghiệm cài đặt và thiết lập PostgreSQL cho người mới bắt đầu. (https://www.postgresql.org/docs/current/tutorial-start.html)
Chuyển đổi chương Kiến thức cơ bản về kiến trúc thành một phần giới thiệu đầy đủ về các hướng dẫn của PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html). Những điều có thể mở rộng là cấu trúc máy khách-máy chủ, psql làm ví dụ về ứng dụng khách sẽ được sử dụng trong hướng dẫn này, thuật ngữ "cụm"" trong ngữ cảnh PostgreSQL, người dùng DB và hệ điều hành và quyền sở hữu.
Cập nhật Hướng dẫn cài đặt (https://www.postgresql.org/docs/current/tutorial-install.html).
- Quảng cáo cả lựa chọn cài đặt nguồn và cài đặt nhị phân. Hãy thêm nội dung tham khảo đến https://www.postgresql.org/download/ nhằm cung cấp hướng dẫn cài đặt tệp nhị phân tối thiểu.
- Xác định các thiếu sót trong hướng dẫn cài đặt tệp nhị phân (nếu có) và mở rộng trang web hoặc giải quyết những thiếu sót trong tài liệu.
- Đừng dựa vào người dùng đọc toàn bộ chương cài đặt nguồn và tìm hiểu: hãy phác thảo các bước chính cần thực hiện sau khi cài đặt, chẳng hạn như khởi động cụm và (tự động) khởi động máy chủ. Cung cấp đường liên kết đến các phân cảnh cụ thể của Tài liệu để cung cấp thêm thông tin chi tiết (nếu có).
- Thêm đường liên kết xem cũng như tài nguyên liên quan mở rộng về các chế độ mặc định và phương pháp hay nhất cho một hệ điều hành cụ thể, nếu có bất kỳ tài nguyên nào được cộng đồng công nhận.
Cải thiện https://www.postgresql.org/docs/current/tutorial-createdb.html
- Loại bỏ hướng dẫn ""tham khảo ý kiến của quản trị viên"" bất cứ khi nào có thể; cung cấp các giải pháp khả thi dựa trên giả định rằng người dùng làm theo hướng dẫn từng bước.
Cải thiện https://www.postgresql.org/docs/current/tutorial-accessdb.html
- Giải thích các vấn đề cơ bản liên quan đến xác thực và các ví dụ nhỏ về pg_hba.conf
Để cung cấp bản vá tài liệu này, tôi dự định dùng thử hướng dẫn hiện tại trên Windows và Ubuntu, duyệt qua các diễn đàn để biết các vấn đề thường gặp khi thiết lập và tham khảo ý kiến của cố vấn để đảm bảo tôi có được các phương pháp hay nhất đúng cách và các khái niệm quan trọng nhất được giải thích mà không cần đơn giản hoá quá mức.