Đóng góp cho tài liệu về Bazel

Cảm ơn bạn đã đóng góp cho tài liệu của Bazel! Chúng tôi có một số cách giúp bạn tạo tài liệu tốt hơn cho cộng đồng.

Loại tài liệu

Trang web này bao gồm một số loại nội dung.

  • Tài liệu tường thuật: do các cây bút và kỹ sư kỹ thuật viết. Phần lớn nội dung của trang web này là tài liệu dạng tường thuật, trong đó có các hướng dẫn về khái niệm và nhiệm vụ.
  • Tài liệu tham khảo, được tạo từ các nhận xét về mã. Bạn không thể trực tiếp thay đổi các trang tài liệu tham khảo, mà phải thay đổi nguồn của các trang đó.

Cơ sở hạ tầng tài liệu

Tài liệu về Bazel do Google cung cấp 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ể thay đổi tệp nguồn trên GitHub. Nếu được phê duyệt, bạn có thể hợp nhất các thay đổi và một đơn vị bảo trì Bazel sẽ cập nhật nguồn trang web để phát hành nội dung cập nhật của bạn.

Thay đổi nhỏ

Bạn có thể thực hiện các thay đổi nhỏ, chẳng hạn như sửa lỗi hoặc lỗi chính tả, theo một số cách.

  • Yêu cầu kéo. Bạn có thể tạo yêu cầu lấy dữ liệu trong GitHub bằng 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 cũng như các thay đổi được đề xuất và chủ sở hữu tài liệu Bazel sẽ thực hiện cập nhật.

Thay đổi lớn

Nếu muốn thực hiện những thay đổi đáng kể đối với tài liệu hiện có hoặc đề xuất 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 của Google rồi liên hệ với Chủ sở hữu Bazel để cộng tác.