Yeni belgelendirme siteleri oluşturun ve yayınlayın

Şablon depoyu klonlayın: https://pagure.io/fedora-docs/template

Yeni belgelendirme seti için yeni bir depo oluşturun veya birilerinden sizin için bir tane oluşturmasını isteyin. Bu depoyu herhangi bir yerde barındırabilirsiniz, ancak depoya yazma erişimini denetlemek için Fedora gruplarını yeniden kullanabileceğiniz pagure.io üzerinde barındırmanız tavsiye edilir. Konuya bağlı olarak, fedora-docs altında barındırmak da en iyisi olabilir.

İçerik setiniz için yeni oluşturulan depoyu klonlayın.

Şablon deponun içeriğini (.git dizini olmadan) yeni oluşturulan depoya kopyalayın veya işlem (commit) geçmişini şablon depodan içe aktarın.

Yeni depoda, depo kök dizinindeki antora.yml yapılandırma dosyasını düzenleyin. Dosya, hangi kısımları değiştirmeniz gerektiğini gösteren yorumlar içermektedir. En azından, name ve title bölümlerini her zaman değiştirin.

Ayrıca, site.yml yapılandırma dosyasını düzenleyin. Bu dosyanın yalnızca içerik setinizin yerel bir ön izlemesini oluştururken kullanıldığını unutmayın - web sitesinde, site geneline ait site.yml yapılandırması tarafından geçersiz kılınmaktadır. Bu dosyada sadece title ve start_page bölümlerini düzenlemeniz gerekmektedir.

Bu noktada, başlangıç yapılandırması tamamlandığında ve depo doğru isim ve gerekli diğer direktiflerle yapılandırıldığında, bu değişiklikleri yeni oluşturulan depoya gönderin (veya doğrudan gönderemezseniz bir çekme isteğinde bulunun). Bu değişiklik seti diğer tüm katkıda bulunmalar için gerekli olacaktır, bu nedenle mümkün olduğunca erken dahil edildiklerinden emin olun.

Güncellemeleri doğrudan göndermemek için yeni deponun bir çatalını oluşturun.

Gerçek ASCIIDoc içeriğini eklemeye başlayın. Yazarken, yeni kaynak dosyalarınızın kullandığınız modülün (öntanımlı olarak ./modules/ROOT/, öncesinde antora.yml dosyasında yapılandırdığınıza göre konum değişecektir) nav.adoc yapılandırma dosyasına dahil edildiğinden emin olun. Ayrıca işaretlemenizi denetlemek için yerel ön izlemeyi sıklıkla kullanın.

İşiniz bittiğinde, değişikliklerinizi kaydedin ve bunları çatalınıza gönderin (commit & push).

Çatal deponuzdan ana deponun master dalına çekme isteği yapmak için Pagure’yi kullanın.

Birisi çekme isteğinizi görecek ve birleştirecek ya da değiştirmeniz gereken bir şey varsa geri bildirim sağlayacaktır. Yaptığınız katkıların standartlara uygun olduğundan emin olmak için yorum yapan kişilerle uyumlu çalışın.

Yeni içeriğinizin ilk kez yayınlanması gerekecektir ve şu anda bu otomatik olarak gerçekleşmemektedir. docs e-posta listesine içeriğinizin yayınlanmasını talep eden bir e-posta gönderin.