Markdown Biçimleri (Bilgilendirme)

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.

Beginne mit 1-js/01-getting-started/2-manuals-specifications/article.md und vergleiche es mit der englischen Version; verwende die verlinkten markdownlint-Regeln, um Formatierungsverstöße zu identifizieren. Überprüfe die anderen türkischen Markdown-Dateien auf ähnliche Weise; als erledigt gilt die Aufgabe, wenn Formatierungsprobleme wie MD022 korrigiert sind, während Korrekturen von Tippfehlern und inhaltliche Korrekturen nicht zum Umfang gehören.