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 Phần Google 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:
- lu
- Tên dự án:
- Hướng dẫn cơ bản
- Thời lượng dự án:
- Thời gian tiêu chuẩn (3 tháng)
Mô tả dự án
Cập nhật phần hướng dẫn giới thiệu để 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 chương Kiến thức cơ bản về kiến trúc thành phần giới thiệu đầy đủ thành hướng dẫn về PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html). Những thứ có thể mở rộng là kiến trúc ứng dụng-máy chủ, psql làm ví dụ ứng dụng đượ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 cơ sở dữ liệu và hệ điều hành, cũng như quyền sở hữu.
Hướng dẫn cài đặt bản cập nhật (https://www.postgresql.org/docs/current/tutorial-install.html).
- Quảng cáo cả tuỳ chọn cài đặt nguồn và nhị phân. Thêm tài liệu tham khảo đến https://www.postgresql.org/download/. Trang này cung cấp hướng dẫn cài đặt tệp nhị phân tối thiểu.
- Xác định lỗ hổng 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 việc người dùng đọc toàn bộ chương cài đặt nguồn và tự tìm hiểu. Hãy nêu 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 chương Tài liệu cụ thể để biết thêm thông tin chi tiết (nếu có).
- Thêm đường liên kết xem cả đến tài nguyên có 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ộng đồng công nhận một hệ điều hành nào đó.
Cải thiện https://www.postgresql.org/docs/current/tutorial-createdb.html
- Bỏ qua 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ụ đơn giản 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 để tìm hiểu các vấn đề thường gặp về việc thiết lập và tham khảo ý kiến của các chuyên gia cố vấn để đảm bảo tôi nắm được đúng các phương pháp hay nhất cũng như các khái niệm quan trọng nhất được giải thích mà không đơn giản hoá.