javascript-tutorial / javascript-tutorial/ko.javascript.info
heading에는 되도록이면 한국어만 쓰기
オープン
enhancement
- 主要言語
- HTML
- スター
- 2k
- フォーク
- 852
- PR マージ指標
- 30日以内にマージされた PR はありません
説明
markdown에서 샵(`#`)으로 시작하는 줄을 heading이라고 부르는데, 헤딩은 목차의역할을 함.
목차엔 영어를 혼용하지 않는 것이 대다수의 출판 서적이 지키고 있는 규칙같아보이는데, 본 튜토리얼에선 키워드 최초 등장시 한-영 병기를 사용하자는 규칙을 정하여서 heading에서도 한-영병기가 사용된 경우가 많음.
이부분에 대한 정리가 필요해 보임
コントリビューションガイド
調査の方向性
まず、チュートリアルの Markdown 見出しと、キーワードが初めて登場したときに韓国語と英語のペアを使用する既存のルールを確認します。見出しでこれらのペアをどのように扱うかを決め、その方針をチュートリアル全体に一貫して適用してから、目次が理解しやすい状態で維持されていることを確認します。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- markdown
- 領域
- content, documentation, localization
- issue の種類
- ドキュメント
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 活発さ
- 停滞
- 明瞭さ
- 説明が足りない
- 初心者へのやさしさ
- 30/100