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

Markdown Biçimleri (Bilgilendirme)

Aberta
#171 0 comentários 0 reações 0 responsáveis Ver no GitHub
Linguagem predominante
HTML
Estrelas
367
Forks
114
Métricas de merge de PRs
Nenhum PR com merge em 30d

Descrição

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.

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Direção de pesquisa

Comece com 1-js/01-getting-started/2-manuals-specifications/article.md e compare-o com a versão em inglês, usando as regras vinculadas do markdownlint para identificar violações de formatação. Revise os outros arquivos Markdown em turco da mesma forma; considera-se concluído quando problemas de formatação como MD022 forem corrigidos, enquanto correções de erros de digitação e de significado estão fora do escopo.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
markdown, vscode
Domínio
documentation
Tipo de issue
Documentação
Dificuldade
4/5
Tempo estimado
3-5 dias
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
35/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.