diff --git a/docs/contributing/how-to-label-an-issue.md b/docs/contributing/how-to-label-an-issue.md index 44e478d1f..0cd7e1286 100644 --- a/docs/contributing/how-to-label-an-issue.md +++ b/docs/contributing/how-to-label-an-issue.md @@ -1,97 +1,97 @@ --- -title: How to label an issue +title: Issue にラベルを付ける方法 --- -## What are Issue labels? +## Issue ラベルとは何ですか？ -Issue labels are a tool in GitHub that are used to group Issues into one or more categories. +Issue ラベルは Issue を 1 つ以上のカテゴリーへ分類するために使用される GitHub のツールです。 -[Check out Gatsby's labels (and their descriptions)](https://github.com/gatsbyjs/gatsby/issues/labels) +[Gatsby のラベル（およびその説明）をご覧ください](https://github.com/gatsbyjs/gatsby/issues/labels) -## Why label Issues? +## なぜ Issue にラベルを付けるのですか？ -Gatsby is a very active project with many new Issues opened each day. Labelling Issues helps by identifying: +Gatsby は毎日たくさんの新しい Issue が公開される非常に活発なプロジェクトです。Issue にラベルを付けることは以下を識別することに役立ちます。 -- good Issues for new contributors to work on -- reported and confirmed bugs -- feature requests -- duplicate Issues -- Issues that are stalled or blocked +- 新しい貢献者が取り組むべき Issue +- 報告や確認がされたバグ +- 機能のリクエスト +- 重複する Issue +- 停止またはブロックされている Issue -## Who can label Issues? +## 誰が Issue にラベルを付けることができますか？ -Anyone who's a member of the [Gatsby Maintainers team](https://github.com/orgs/gatsbyjs/teams/maintainers) can label Issues. +[Gatsby メンテナチーム](https://github.com/orgs/gatsbyjs/teams/maintainers)のメンバーであれば誰でも Issue にラベルを付けることができます。 -You can get an invite to the team by having a Pull Request merged into the Gatsby project. Check out the list of [`help wanted`](https://github.com/gatsbyjs/gatsby/labels/%F0%9F%93%8D%20status%3A%20help%20wanted) Issues and the [How To Contribute Guide](/contributing/how-to-contribute/) to get started. +Pull Request が Gatsby プロジェクトにマージされるとチームに招待されます。開始するには [`help wanted`](https://github.com/gatsbyjs/gatsby/labels/%F0%9F%93%8D%20status%3A%20help%20wanted) タグがついた Issue 一覧と[貢献ガイド](/contributing/how-to-contribute/)をご覧ください。 -**NOTE:** If you’ve already had a Pull Request merged and you have _not_ been invited to the maintainers team, please go to [the dashboard](https://store.gatsbyjs.org/) and request a discount code. You should get an invite to the team — _and you get free Gatsby swag!_ If that doesn’t work, please email team@gatsbyjs.com and we'll get you invited. +**ヒント** Pull Request がすでにマージされていて、メンテナチームに招待されて_いない_場合は、[ダッシュボード](https://store.gatsbyjs.org/) にアクセスして割引コードをリクエストしてください。チームに招待されるはずです。— _そして Gatsby の景品が無料で手に入ります！_ それでも解決しない場合は、team@gatsbyjs.com にメールを送ってください。招待します。 -## How to label an Issue +## Issue にラベルを付ける方法 -Ideally, every Issue should have a single `type:` label applied to it. Optionally a `status:` label or other labels may also be applied. +全ての Issue に単一の `type:` ラベルが付けられているのが理想的です。必要に応じて `status:` ラベルまたは他のラベルを付けることもできます。 -Before continuing, get familiar with [Gatsby's issue labels and their descriptions](https://github.com/gatsbyjs/gatsby/issues/labels). +続ける前に、[Gatsby の Issue ラベルおよびその説明](https://github.com/gatsbyjs/gatsby/issues/labels)をよく理解してください。 -The broad steps to labelling an Issue are: +Issue にラベルを付けるための広範な手順は次のとおりです。 -- Read an Issue -- Choose the labels that apply to that Issue -- That's it - sit back and relax, maybe take a few moments to enjoy the satisfaction of a job well done +- Issue を読んでください。 +- Issue に付けるラベルを選択してください。 +- それだけです。 - 座ってリラックスして、少し時間をとって作業の満足度を楽しみましょう。 -The rest of this document will describe how to choose the right labels for an Issue. +このドキュメントの残りの部分では、Issue に適切なラベルを選択する方法について説明します。 -### Find an Issue that you're interested in +### 興味のある Issue を探してください -Start with [Gatsby's issues list](https://github.com/gatsbyjs/gatsby/issues) and scroll through until you see a recent one that strikes your interest. Alternatively, you can view the [list of unlabelled issues](https://github.com/gatsbyjs/gatsby/issues?q=is%3Aopen+is%3Aissue+no%3Alabel). +[Gatsby の Issue 一覧](https://github.com/gatsbyjs/gatsby/issues)を開いて、最近の興味のあるものが見つかるまでスクロールしてください。または、[ラベルのない Issue 一覧](https://github.com/gatsbyjs/gatsby/issues?q=is%3Aopen+is%3Aissue+no%3Alabel)も見ることができます。 -### Read the Issue +### Issue を読んでください -Read the Issue and any comments to understand what the Issue is about. +Issue やコメントを読んで、Issue について理解してください。 -### Choose one `type:` label +### ラベルの `type:` を 1 つ選択してください -Choose a type label from the _labels_ dropdown to the right-hand side of the Issue. +Issue の右側にある _labels_ のドロップダウンから type ラベルを選択してください。 -![GitHub label dropdown](./images/github-label-list.png) +![GitHub の label ドロップダウン](./images/github-label-list.png) -You can check through the [label descriptions](https://github.com/gatsbyjs/gatsby/issues/labels) for more information on each one. +各ラベルの詳細については、[ラベルの説明](https://github.com/gatsbyjs/gatsby/issues/labels)を確認してください。 -The most common type of Issue is `type: question or discussion`, typically you can apply this to Issues that are open-ended or have no clear next step. +もっとも一般的な Issue の type は `type: question or discussion` です。通常これは Issue を議論の場として使用するとき、または明確な次の手段がない Issue に付けることができます。 -It's OK to change the type of an Issue as more information becomes available. What starts as `type: question or discussion`, might later need to be changed to `type: bug`. +詳細が明確になったら Issue の type を変更しても構いません。`type: question or discussion` で始まるものは、後で `type: bug` に変更する必要があるかもしれません。 -Changing labels is quick and easily reversible, so don't worry too much about applying a "wrong" label. +ラベルの変更はすぐ簡単に元に戻すことができるため、「間違った」ラベルを付けることについてあまり心配する必要はありません。 -Choose an appropriate `type:` label and you're ready to move on to the next step. +適切な `type:` ラベルを選択すると、次のステップに進む準備が整います。 -### Choose a `status:` label (optional) +### ラベルの `status:` を選択してください（任意） -Check through the [`status:` labels (and their descriptions)](https://github.com/gatsbyjs/gatsby/issues/labels), if any apply to this Issue add them as necessary. +[`status:` ラベル（およびその説明）](https://github.com/gatsbyjs/gatsby/issues/labels)を確認して、Issue に該当する場合は必要に応じてラベルを付けてください。 -Examples of applying `status:` labels might be: +`status:` ラベルを付ける例は次の通りです。 -- An Issue that depends on an external dependency being changed could be labelled with `status: blocked` +- 変更される外部の依存性に依存する Issue には `status: blocked` -- An Issue with a clear description of how it can be resolved could be labelled `status: help wanted`. +- 解決する方法について明確な記述がある Issue には `status: help wanted` -- An Issue that's missing information required to help the author could be labelled with `status: needs more info` +- 作成者を助けるために必要な情報が欠けている Issue には `status: needs more info` -- An Issue describing a bug without clear steps to reproduce could be labelled with `status: needs reproduction` +- 明確な再現手順が欠けているバグ報告の Issue には `status: needs reproduction` -- An Issue describing a bug where there are steps to reproduce the bug _and_ you've run the code locally and seen the error yourself can be labelled `status: confirmed` +- バグの明確な再現手順が書かれていて、コードをローカルで動かしてエラーを確認できたバグ報告の Issue には `status: confirmed` -### Choose any other labels +### 他のラベルを選択してください -There are a few other labels that can sometimes be applied to an Issue. Here are some more examples of when to use them: +Issue に付けられるラベルは他にもいくつかあります。それらを使う場合の例をいくつか示します。 -- `good first issue` can be used when an Issue is a small, clearly defined piece of work that could be completed by someone without in-depth knowledge of Gatsby and how it works. These Issues are particularly suitable for people making their first open source contributions. +- `good first issue` は Gatsby とその仕組みのついて深い知識がなくても完了できる、明確に定義された小さな Issue で使用できます。これらの Issue は初めてオープンソースへ取り組む人々に特に適しています。 -- `stale?` can be used on an Issue where the author has not replied to requests for further information in at least 20 days. +- `stale?` は作成者が少なくとも 20 日以内に詳細な情報のリクエストに返信していない Issue で使用できます。 -### Finish +### 最後に -And you're done! You can call it a day or go back to the first step to label another Issue. +これで完了です！これで終わりにするか、最初のステップに戻って他の Issue にラベルを付けましょう。 -## Conclusion +## まとめ -Labelling Issues is a great way to help out on the Gatsby project regardless of your experience level. +Issue へのラベル付けは経験度合いに関係なく Gatsby プロジェクトへ貢献できる素晴らしい方法です。