Bazel'ın dokümanlarına katkıda bulunduğunuz için teşekkür ederiz! Topluluğumuz için daha iyi dokümanlar oluşturmaya yardımcı olacak birkaç yol var.
Belge türleri
Bu sitede birkaç türde içerik bulunmaktadır.
- Teknik yazarlar ve mühendisler tarafından yazılan anlatım belgeleri. Bu sitenin büyük kısmı, kavramsal ve göreve dayalı rehberleri kapsayan anlatı belgeleridir.
- Kod yorumlarından oluşturulan dokümanlar olan referans dokümanları. Referans doküman sayfalarında doğrudan değişiklik yapamazsınız, bunun yerine kaynaklarını değiştirmeniz gerekir.
Belgeleme altyapısı
Bazel belgeleri Google'dan sunulur ve kaynak dosyalar Bazel'ın GitHub deposuna yansıtılır. GitHub'da kaynak dosyalarda değişiklik yapabilirsiniz. Onaylanırsa değişiklikleri birleştirebilirsiniz. Bunun ardından, bir Bazel güncelleyicisi güncellemelerinizi yayınlamak için web sitesi kaynağını günceller.
Küçük değişiklikler
Hataları veya yazım hatalarını düzeltme gibi küçük değişikliklere birkaç şekilde yaklaşabilirsiniz.
- Pull isteği. GitHub'da web tabanlı düzenleyiciyle veya bir dalda pull isteği oluşturabilirsiniz.
- Hata. Ayrıntıları ve önerilen değişiklikleri içeren bir hata bildiriminde bulunabilirsiniz. Bazel belge sahipleri güncellemeyi yapar.
Büyük değişiklikler
Mevcut belgelerde önemli değişiklikler yapmak veya yeni belgeler önermek istiyorsanız pull isteği oluşturabilir ya da bir Google dokümanıyla başlayabilir ve ortak çalışmak için Bazel Sahipleri ile iletişime geçebilirsiniz.