Chào mừng! Kho lưu trữ này chứa tất cả các tài nguyên cần thiết để xây dựng trang web của Kubernetes và các tài liệu. Chúng tôi rất vui vì bạn muốn đóng góp.
Bạn có thể click vào nút Fork ở góc trên bên phải màn hình để tạo bản sao của kho lưu trữ này trong tài khoản GitHub của bạn. Bản sao này được gọi là một bản fork. Thực hiện bất kì thay đổi nào mà bạn muốn trong bản fork của bạn và khi bạn sẵn sang gửi những thay đổi đó cho chúng tôi, hãy đến bản fork của bạn và tạo một Pull Request mới để cho chúng tôi biết về nó.
Một khi Pull Request của bạn được tạo, reviewer sẽ chịu trách nhiệm cung cấp các phản hồi rõ ràng, có thể thực hiện được. Là chủ sở hữu của pull request, bạn có trách nhiệm sửa đổi Pull Request của mình để giải quyết các phản hồi bởi reviewer. Ngoài ra, lưu ý rằng bạn có thể có nhiều hơn một reviewer cung cấp cho bạn các phản hồi hoặc bạn có thể nhận được phản hồi từ reviewer khác với reviewer ban đầu được chỉ định. Hơn nữa, trong một số trường hợp, một trong những reviewer của bạn có thể yêu cầu đánh giá kỹ thuật từ Kubernetes tech reviewer khi cần. Các reviewers sẽ cố gắng hết sức để cung cấp phản hồi một cách kịp thời nhưng thời gian phản hồi có thể thay đổi tùy theo hoàn cảnh.
Để biết thêm thông tin về việc đóng góp cho tài liệu Kubernetes, hãy xem:
- Bắt đầu đóng góp
- Các giai đoạn thay đổi tài liệu
- Sử dụng các trang templates
- Hướng dẫn biểu mẫu tài liệu
- Địa phương hóa tài liệu Kubernetes
Cách được đề xuất để chạy trang web Kubernetes cục bộ là dùng Docker image chứa trình tạo web tĩnh Hugo.
Nếu bạn làm việc trên môi trường Windows, bạn sẽ cần thêm môt vài công cụ mà bạn có thể cài đặt với Chocolatey.
choco install make
Nếu bạn không muốn dùng Docker để chạy trang web cục bộ, hãy xem [Chạy website cục bộ dùng Hugo](#Chạy website cục bộ dùng Hugo) dưới đây.
Nếu bạn có Docker đang up và running, build kubernetes-hugo
Docker image cục bộ:
make docker-image
Khi image đã được built, bạn có thể chạy website cục bộ:
make docker-serve
Mở trình duyệt và đến địa chỉ http://localhost:1313 để xem website. Khi bạn thay đổi các file nguồn, Hugo cập nhật website và buộc làm mới trình duyệt.
Hãy xem tài liệu chính thức của Hugo cho việc hướng dẫn cài đặt Hugo. Đảm bảo cài đặt phiên bản mở rộng của Hugo được xác định bởi biến môi trường HUGO_VERSION
trong file netlify.toml
Để chạy website cục bộ khi Hugo được cài đặt:
make serve
Câu lệnh trên sẽ khởi động server Hugo cục bộ trên cổng 1313. Mở trình duyệt và đến địa chỉ http://localhost:1313 để xem website. Khi bạn thay đổi các file nguồn, Hugo cập nhật website và buộc làm mới trình duyệt.
Tìm hiểu cách tham gia với cộng đồng Kubernetes trên trang cộng đồng.
Bạn có thể tiếp cận những maintainers của dự án này tại:
Sự tham gia vào cộng đồng Kubernetes được điểu chỉnh bởi Kubernetes Code of Conduct.
Kubernetes phát triển mạnh mẽ về sự tham gia của cộng đồng và chúng tôi đánh giá cao những đóng góp của bạn cho trang web và tài liệu của chúng tôi!