Bazel'in dokümanlarına katkıda bulunduğunuz için teşekkür ederiz. Topluluğumuz için daha iyi dokümanlar oluşturmanın birkaç yolu vardır.
Belge türleri
Bu sitede az sayıda içerik türü bulunmaktadır.
- Teknik yazarlar ve mühendisler tarafından yazılan anlatım belgeleri. Bu sitenin büyük bir kısmı, kavramsal ve görev temelli Kılavuzları kapsayan anlatısal belgelerden oluşur.
- Kod yorumlarından oluşturulan belgeler olan Referans belgeler. 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. Bir Bazel sağlayıcısı, 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şiklikler için birkaç yöntemden yararlanabilirsiniz.
- Çekme isteği. GitHub'da web tabanlı düzenleyiciyle veya bir dalla pull isteği oluşturabilirsiniz.
- Hata. Ayrıntıları ve önerilen değişiklikleri içeren bir hata bildiriminde bulunabilirsiniz. Bazel dokümanlarının sahipleri güncellemeyi uygular.
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 belgesiyle başlayıp Bazel Sahipleriyle işbirliği yaparak iletişime geçebilirsiniz.