Skip to content
This repository was archived by the owner on Jan 20, 2025. It is now read-only.
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
102 changes: 51 additions & 51 deletions docs/contributing/how-to-label-an-issue.md
Original file line number Diff line number Diff line change
@@ -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 [email protected] and we'll get you invited.
**ヒント** Pull Request がすでにマージされていて、メンテナチームに招待されて_いない_場合は、[ダッシュボード](https://store.gatsbyjs.org/) にアクセスして割引コードをリクエストしてください。チームに招待されるはずです。— _そして Gatsby の景品が無料で手に入ります!_ それでも解決しない場合は、[email protected] にメールを送ってください。招待します。

## 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 プロジェクトへ貢献できる素晴らしい方法です。