javascript-tutorial / javascript-tutorial/tr.javascript.info

Markdown Biçimleri (Bilgilendirme)

Abierto
#171 0 comentarios 0 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
HTML
Estrellas
367
Forks
114
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

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.

![image](https://user-images.githubusercontent.com/1656836/105614275-76f53580-5dd9-11eb-99fa-cf00b6bc075b.png)

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.

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Línea de trabajo

Comienza con 1-js/01-getting-started/2-manuals-specifications/article.md y compáralo con la versión en inglés, utilizando las reglas de markdownlint enlazadas para identificar infracciones de formato. Revisa de forma similar los demás archivos Markdown en turco; se considera terminado cuando se corrigen problemas de formato como MD022, mientras que las correcciones de errores tipográficos y de significado quedan fuera del alcance.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
markdown, vscode
Área
documentation
Tipo de issue
Documentación
Dificultad
4/5
Tiempo estimado
3-5 días
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.