javascript-tutorial / javascript-tutorial/tr.javascript.info
Markdown Biçimleri (Bilgilendirme)
- 主要語言
- HTML
- 星號
- 367
- 分支
- 114
- PR 合併指標
- 30 天內沒有已合併 PR
描述
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](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) adında bir VS Code eklentisi var. Ayrıca bu [repoda](https://github.com/DavidAnson/markdownlint) 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.
貢獻指南
這個儲存庫沒有索引到貢獻指南
研究方向
從 1-js/01-getting-started/2-manuals-specifications/article.md 開始,將其與英文版本進行比較,並使用連結的 markdownlint 規則來識別格式違規。以相同方式檢查其他土耳其文 Markdown 檔案;完成的標準是修正 MD022 等格式問題,而拼字和意義修正不在範圍內。
由索引模型根據 Issue 內容生成。
評估
- 技術堆疊
- markdown, vscode
- 領域
- documentation
- Issue 類型
- 文件
- 難度
- 4/5
- 預估耗時
- 3-5 天
- 活躍度
- 停滯
- 描述清晰度
- 基本清楚
- 新手友好度
- 35/100