blob: 94863f9fe148f647d8de87363e314daafa0919ca (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
---
title: MDN コンテンツのバグ修正
slug: MDN/Contribute/Fixing_MDN_content_bugs
tags:
- Bugs
- Contribute
- MDN
---
<p>{{MDNSidebar}}</p>
<p>MDN の文書に関する問題は、<a href="https://github.com/mdn/content/issues">コンテンツリポジトリーの課題 (issue)</a> として報告されます (また、以前の <a href="https://github.com/mdn/sprints/issues">sprints リポジトリー</a>にも未解決の課題があります)。この記事では、あなたの専門知識と作業可能な時間に基づいて、作業するのに最適な問題を見つけ、それらを修正するための主な手順を概説します。</p>
<div class="notecard note">
<strong>注</strong>
<p>コンテンツのバグはたくさんあります。修正するためにご協力いただけるのであれば、何でも助かります。</p>
</div>
<div class="notecard note">
<strong>訳注:</strong> この記事は原文 (英語) の記事の修正に関する案内です。そのため、下記のリンクは英語版の文書に対するリンクになっています。日本語訳の課題については <a href="https://github.com/mdn/translated-content/labels/l10n-ja">translated-content リポジトリー上の l10n-ja の課題</a>や <a href="https://github.com/mozilla-japan/translation/issues">mozilla-japan/translation リポジトリー上の課題</a>を参照してください。
</div>
<h2 id="What_do_we_need_help_with">協力が必要なこと</h2>
<p>コンテンツのどの課題に取り組むべきかを選択するのに役立つよう、 GitHub のラベルを使って分類しました。</p>
<p>以下のラベルは、どれだけ時間があるかによってタスクを探すのに役立ちます。</p>
<table class="standard-table">
<thead>
<tr>
<th scope="col">ラベル</th>
<th scope="col">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<a href="https://github.com/mdn/content/issues?q=is%3Aissue+is%3Aopen+label%3A%2210+minute+task%22">content リポジトリー上の 10 分のタスク</a><br>
<a href="https://github.com/mdn/sprints/issues?q=is%3Aissue+is%3Aopen+label%3A%2210+minute+task%22">sprints リポジトリー上の 10 分のタスク</a></td>
<td>本当に簡単なタスクで、おそらく10分以内で終わるものです。</td>
</tr>
<tr>
<td>
<a href="https://github.com/mdn/content/issues?q=is%3Aissue+is%3Aopen+label%3A%2230+minute+task%22">content リポジトリー上の 30 分のタスク</a><br>
<a href="https://github.com/mdn/sprints/issues?q=is%3Aissue+is%3Aopen+label%3A%2230+minute+task%22">sprints リポジトリー上の 30 分のタスク</a>
</td>
<td>少し手間のかかる作業で、 30 分ほどかかるかもしれません。</td>
</tr>
<tr>
<td>
<a href="https://github.com/mdn/content/issues?q=is%3Aissue+is%3Aopen+label%3A%221+hour+task%22">content リポジトリー上の 1 時間のタスク</a><br>
<a href="https://github.com/mdn/sprints/issues?q=is%3Aissue+is%3Aopen+label%3A%221+hour+task%22">sprints リポジトリー上の 1 時間のタスク</a>
</td>
<td>長いタスクで、 1 時間、あるいは 2 時間ほどかかるかもしれません。</td>
</tr>
<tr>
<td>
<a href="https://github.com/mdn/content/issues?q=is%3Aissue+is%3Aopen+label%3A%22multiple+hour+task%22">リポジトリー上の数時間のタスク</a><br>
<a href="https://github.com/mdn/sprints/issues?q=is%3Aissue+is%3Aopen+label%3A%22multiple+hour+task%22">リポジトリー上の数時間のタスク</a>
</td>
<td>とても奥の深い作業で、完了までに数時間かかりそうです。</td>
</tr>
</tbody>
</table>
<p>技術のカテゴリー別にタスクを見たり選択したりしたい場合は、プロジェクトボードにまとめられた同じ課題から探すこともできます。</p>
<table class="standard-table">
<thead>
<tr>
<th scope="col">プロジェクトボード</th>
<th scope="col">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="https://github.com/mdn/sprints/projects/12">Learn docs MDN project board</a></td>
<td><a href="/ja/docs/Learn">Learn Web Development</a> に関する課題。</td>
</tr>
<tr>
<td><a href="https://github.com/mdn/sprints/projects/11">Content architecture MDN </a><a href="https://github.com/mdn/sprints/projects/12">project</a><a href="https://github.com/mdn/sprints/projects/11"> board</a></td>
<td>一般的なコンテンツ、ページの構成、その他の MDN 上の雑務に関する課題。</td>
</tr>
<tr>
<td><a href="https://github.com/mdn/sprints/projects/10">HTTP docs MDN </a><a href="https://github.com/mdn/sprints/projects/12">project</a><a href="https://github.com/mdn/sprints/projects/10"> board</a></td>
<td><a href="/ja/docs/Web/HTTP">HTTP</a> の文書に関する課題</td>
</tr>
<tr>
<td><a href="https://github.com/mdn/sprints/projects/9">HTML docs MDN </a><a href="https://github.com/mdn/sprints/projects/12">project</a><a href="https://github.com/mdn/sprints/projects/9"> board</a></td>
<td><a href="/ja/docs/Web/HTML">HTML</a> の文書に関する課題</td>
</tr>
<tr>
<td><a href="https://github.com/mdn/sprints/projects/8">DevTools docs MDN </a><a href="https://github.com/mdn/sprints/projects/12">project</a><a href="https://github.com/mdn/sprints/projects/8"> board</a></td>
<td>Firefox <a href="/ja/docs/Tools">DevTools</a> の文書に関する課題</td>
</tr>
<tr>
<td><a href="https://github.com/mdn/sprints/projects/7">WebExtensions docs MDN </a><a href="https://github.com/mdn/sprints/projects/12">project</a><a href="https://github.com/mdn/sprints/projects/7"> board</a></td>
<td><a href="/ja/docs/Mozilla/Add-ons/WebExtensions">WebExtensions</a> の文書に関する課題</td>
</tr>
<tr>
<td><a href="https://github.com/mdn/sprints/projects/6">CSS docs MDN </a><a href="https://github.com/mdn/sprints/projects/12">project</a><a href="https://github.com/mdn/sprints/projects/6"> board</a></td>
<td><a href="/ja/docs/Web/CSS/Reference">CSS</a> の文書に関する課題</td>
</tr>
<tr>
<td><a href="https://github.com/mdn/sprints/projects/5">JavaScript docs MDN </a><a href="https://github.com/mdn/sprints/projects/12">project</a><a href="https://github.com/mdn/sprints/projects/5"> board</a></td>
<td><a href="/ja/docs/Web/JavaScript">JavaScript</a> の文書に関する課題</td>
</tr>
</tbody>
</table>
<h2 id="How_can_you_benefit">どんなメリットがあるのか</h2>
<ul>
<li>MDN のコンテンツのバグを修正することは、ウェブ技術をより深く学ぶための素晴らしい方法です。問題を調査し、必要なコンテンツを作成することで、そのテーマに対する理解が深まり、自分のスキルが向上します。</li>
<li>また、 MDN コミュニティに参加することで、 Mozilla のスタッフや他のコミュニティメンバーと知り合うことができ、自分が抱えている問題を助けてもらったり、自分の知名度を高めたりするための貴重なネットワークとなります。</li>
<li>問題の解決に協力することは、それだけで大きな報酬になりますが、オープンソースへの貢献の記録にもなり、自分のウェブ技術に関する専門知識を証明することになり、場合によっては進路や就職の際にも役立つでしょう。</li>
</ul>
<h2 id="What_skills_do_you_need">必要なスキルは何か</h2>
<ul>
<li>手伝っていただくことにしたトピック領域 (JavaScript、CSS など) についての知識が必要です。</li>
<li>手伝っていただく例やページのほとんどは英語で書かれていますので、英語を適度に理解している必要があります。しかし、英語が完璧でなくても心配しないでください。私たちのチームは、どのように書いてもきれいに仕上げることが大好きです。</li>
</ul>
<h2 id="How_to_help">手伝う方法</h2>
<ol>
<li>最初に、 <a href="https://github.com/join">GitHub アカウント</a>をまだお持ちでなければサインアップしてください。 GitHub の課題でやり取りするのに必要です。</li>
<li>次に、手伝いたいトピック領域を 1 つ以上選んでください。上記の一覧を使用して、より詳しい情報を得ると選択をするのに役立ちます。何を選べばよいのか分からない場合は、 <a href="https://wiki.mozilla.org/Matrix">Matrix</a> の <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">MDN Web Docs チャットルーム</a>で聞いてみましょう。</li>
</ol>
<h3 id="Once_you_are_set_up">セットアップが完了したら</h3>
<ol>
<li>興味のある課題を選んで、その課題に対するコメントを添えて、自分に割り当ててもらいましょう。</li>
<li>作業中に分からないことがあったら、 <a href="https://wiki.mozilla.org/Matrix">Matrix</a> の <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">MDN Web Docs チャットルーム</a>で気軽に相談してください。</li>
<li>問題を修正したら、提出者にレビューを依頼してください。うまくいけば、さらに作業が必要だと思うかどうかを教えてくれるでしょう。必要に応じて私たちも関与します。</li>
<li>課題が修正されたことが確認されたら、閉じることができます。課題を閉じることができる人は、元の課題の提出者か、 MDN のスタッフのどちらかです。</li>
</ol>
<div class="notecard note">
<p><strong>注</strong>: 課題を選択して作業する際には、 <a href="/ja/docs/MDN/Contribute/GitHub_best_practices">GitHub のベストプラクティス</a>や <a href="/ja/docs/MDN/Contribute/Getting_started">MDN で始めよう</a>のガイドも参考になるでしょう。</p>
</div>
|
