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

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

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 dạng tường thuật do các kỹ sư và người viết tài liệu kỹ thuật biên soạn. Hầu hết nội dung trên trang web này là tài liệu dạng tường thuật, bao gồm các hướng dẫn dựa trên khái niệm và nhiệm vụ.
  • Tài liệu tham khảo là tài liệu được tạo từ các nhận xét trong mã. Bạn không thể trực tiếp thay đổi các trang tài liệu tham khảo mà cần thay đổi nguồn của chúng.

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

Tài liệu Bazel được cung cấp từ Google và các tệp nguồn được sao chép trong kho lưu trữ GitHub của Bazel. Bạn có thể thay đổ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à người duy trì Bazel sẽ cập nhật nguồn trang web để xuất bản các 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.

  • Pull request. Bạn có thể tạo yêu cầu kéo 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 và các thay đổi được đề xuất. Chủ sở hữu tài liệu Bazel sẽ thực hiện nội dung cập nhật.

Thay đổi lớn

Nếu muốn thực hiện các 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 yêu cầu kéo hoặc bắt đầu bằng một tài liệu trên Google Tài liệu rồi liên hệ với Chủ sở hữu Bazel để cộng tác.