javascript-tutorial / javascript-tutorial/ko.javascript.info

heading에는 되도록이면 한국어만 쓰기

オープン
#63 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る
enhancement
主要言語
HTML
スター
2k
フォーク
852
PR マージ指標
30日以内にマージされた PR はありません

説明

markdown에서 샵(`#`)으로 시작하는 줄을 heading이라고 부르는데, 헤딩은 목차의역할을 함.

목차엔 영어를 혼용하지 않는 것이 대다수의 출판 서적이 지키고 있는 규칙같아보이는데, 본 튜토리얼에선 키워드 최초 등장시 한-영 병기를 사용하자는 규칙을 정하여서 heading에서도 한-영병기가 사용된 경우가 많음.

이부분에 대한 정리가 필요해 보임

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

まず、チュートリアルの Markdown 見出しと、キーワードが初めて登場したときに韓国語と英語のペアを使用する既存のルールを確認します。見出しでこれらのペアをどのように扱うかを決め、その方針をチュートリアル全体に一貫して適用してから、目次が理解しやすい状態で維持されていることを確認します。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
markdown
領域
content, documentation, localization
issue の種類
ドキュメント
難易度
4/5
見積もり時間
3〜5日
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
30/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。