Cảm ơn bạn đã đóng góp tài liệu của Bazel! Có một vài cách để
giúp tạo ra các tài liệu tốt hơn cho cộng đồng của chúng ta.
Các loại tài liệu
Trang web này có một số loại nội dung.
Tài liệu tường thuật do người viết về kỹ thuật và
kỹ sư. Hầu hết nội dung trên trang web này là tài liệu tường thuật bao gồm
hướng dẫn dựa trên nhiệm vụ và khái niệm.
Tài liệu tham khảo, được tạo từ các nhận xét trong mã.
Bạn không thể trực tiếp thực hiện các thay đổi trên các trang tài liệu tham khảo, mà thay vào đó cần phải
thay đổi nguồn.
Cơ sở hạ tầng của tài liệu
Tài liệu trong Bazel được phân phối từ Google và các tệp nguồn được phản chiếu trong
Kho lưu trữ GitHub của Bazel. Bạn có thể thực hiện thay đổi đối với các tệp nguồn trong GitHub.
Nếu được phê duyệt, bạn có thể hợp nhất các thay đổi đó và một người duy trì Bazel sẽ cập nhật
nguồn trang web để xuất bản các bản cập nhật của bạn.
Thay đổi nhỏ
Bạn có thể tiến hành những thay đổi nhỏ, chẳng hạn như sửa lỗi hoặc lỗi chính tả, bằng một vài cách
nhiều cách.
Yêu cầu lấy dữ liệu. Bạn có thể tạo một yêu cầu lấy dữ liệu (pull request) trong GitHub bằng phương thức
trình chỉnh sửa dựa trên web hoặc trên một nhánh.
Lỗi. Bạn có thể báo cáo lỗi kèm theo thông tin chi tiết và các thay đổi được đề xuất cũng như Bazel
chủ sở hữu tài liệu sẽ thực hiện cập nhật.
Thay đổi lớn
Nếu bạn muốn thay đổi đáng kể tài liệu hoặc đề xuất hiện tại,
tài liệu mới, bạn có thể tạo một yêu cầu lấy dữ liệu hoặc bắt đầu bằng một
tài liệu và liên hệ với Bazel Owners để cộng tác.