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