Markdown Biçimleri (Bilgilendirme)

[kburakozdemir]

Merhaba, depoda markdown (.md) dosyalarında yaptığım hızlı bir inceleme sonrasında bir çok dosyada biçimlendirme problemleri olduğunu gözlemledim. Markdown dosyası yazımında kullandığım markdownlint adında bir VS Code eklentisi var. Ayrıca bu repoda kurallar da yer alıyor.

Markdown kaynak dosyalarının da okunabilirliği tıpkı diğer tüm bilgisayar dillerinin okunabilirliği kadar önemli.

Bunun yanında original dosya (İngilizce versiyon) ile bazı karşılaştırmalar yaptım. Burada emin olmak istediğim bu hataların İngilizce versiyonda olup olmadığıydı. İngilizce versiyonlar genellikle format olarak doğru. Aşağıdaki resimde solda İngilizce ve sağda ilk çevrilmiş Türkçe versiyon var. Dosya 1-js/01-getting-started/2-manuals-specifications/article.md. MD022 kuralı ihlali İngilizce versiyonda yok.

Bu noktada öncelikle format sorunlarının minimum'a indirilmesi gerektiğini düşündüğümden tipo ve anlam bozukluklarından önce format üzerinde çalışmalar yapacağım.