Belgelerin tamamen reStructuredText formatına geçmeli mi?


#1

Belgelendirme tamamen reStructuredText formatına geçse daha mantıklı olmaz mı? Kendi içinde farklı formatlar kullanmasındansa yoğun olarak kullanılan formata geçsek daha rahat olmaz mı?


#2

Asciidoc, reStructuredText’e göre daha kolay bir sözdizimine sahip. Aynı şekilde Asciidoctor’ı kullanması Sphinx’i kullanmaya göre daha kolay. Bu sebeple genel belgelerde Asciidoctor kullanmayı seçmiştim. Ancak reStructuredText ile yazılmış olan istihza belgelerinin bu şekilde geliştirilmeye devam etmesi tabii ki en mantıklısı.