-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: translated contributing/issues into ja
- Loading branch information
Showing
1 changed file
with
75 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,75 @@ | ||
--- | ||
title: イシュー | ||
description: 既存イシューの修正方法、またはバグ、セキュリティ、潜在的な改善の報告方法 | ||
weight: 10 | ||
_issues: https://github.com/open-telemetry/opentelemetry.io/issues | ||
_issue: https://github.com/open-telemetry/opentelemetry.io/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A | ||
default_lang_commit: 01d3e2eee9798dfa7c4a36425621849a2a37e489 | ||
--- | ||
|
||
## 既存のイシューの修正 | ||
|
||
OTel を改善するための最も良い方法の 1 つは、既存のイシューを修正することです。 | ||
|
||
1. [issues]({{% param _issues %}}) のリストを参照してください。 | ||
2. 作業したいイシューを選択してください。短時間で修正できるものが理想です。 | ||
|
||
<!-- prettier-ignore --> | ||
<a name="first-issue"></a> | ||
{{% alert title="最初のコントリビュートですか?" %}} | ||
|
||
以下のラベルのイシューを選択してください。 | ||
|
||
- [Good first issue] | ||
- [Help wanted] | ||
|
||
<!-- prettier-ignore --> | ||
> **NOTE**: メンターシップやオンボーディングプロセスの一部でない限り、私たちは、[OpenTelemetry organization][org] にまだコントリビュートしたことがない人に**イシューをアサインしません**。 | ||
{.mt-3} | ||
|
||
<!-- prettier-ignore --> | ||
[good first issue]: {{% param _issue %}}%22good+first+issue%22 | ||
[help wanted]: {{% param _issue %}}%3A%22help+wanted%22 | ||
[org]: https://github.com/open-telemetry | ||
|
||
{{% /alert %}} | ||
|
||
3. イシューにコメントがある場合、内容を読んでください。 | ||
4. このイシューがまだ関係あるかをメンテナーに尋ね、明らかにしたい質問がある場合はイシューにコメントを投稿して質問してください。 | ||
5. この旨のコメントを追加して、問題に取り組む意向を共有してください。 | ||
6. イシューの修正に取り組みましょう。問題が発生した場合は、メンテナーに知らせてください。 | ||
7. 準備ができれば、[プルリクエストを通じてあなたの作業を提出してください](../pull-requests)。 | ||
|
||
## イシューの報告 | ||
|
||
エラーに気が付いたり既存の内容に改善を提案したい場合は、イシューを開いてください。 | ||
|
||
1. 任意のドキュメントの**ドキュメントのissueを作成**のリンクをクリックしてください。これにより、ヘッダーがあらかじめ入力された GitHub のイシューページにリダイレクトされます。 | ||
2. 問題点または改善の提案を説明してください。できるだけ多くの詳細を提供してください。 | ||
3. **作成** をクリックしてください。 | ||
|
||
提出した後に、あなたのイシューを時々確認するか、GitHub の通知をオンにしてください。 | ||
メンテナーと承認者が反応するまで、数日かかる場合があります。 | ||
レビュアーやほかのコミュニティメンバーがイシューに対処する前に質問する場合があります。 | ||
|
||
## 新しいコンテンツや機能の提案 | ||
|
||
新しいコンテンツや機能のアイデアを持っているが、どこに配置すべきかわからない場合、イシューに提出できます。 | ||
バグとセキュリティの脆弱性も同様に報告できます。 | ||
|
||
1. [GitHub](https://github.com/open-telemetry/opentelemetry.io/issues/new/) に行って **Issues** タブ内の **New issue** を選択してください。 | ||
2. 要望または疑問に最も適したイシューの種類を選択してください。 | ||
3. テンプレートに入力してください。 | ||
4. イシューを提出してください。 | ||
|
||
### 優れたイシューの作成方法 | ||
|
||
イシューを作成する際には、以下の点に注意してください。 | ||
Keep the following in mind when filing an issue: | ||
|
||
- 明確な説明を提供してください。何が欠けていて、古くなっていて、間違っていて改善を必要としているのか説明してください。 | ||
- ユーザーへの具体的な影響を説明してください。 | ||
- イシューの範囲は合理的な範囲に制限してください。問題の範囲が大きい場合は、小さなイシューに分割してください。例えば、「セキュリティドキュメントを修正する」は広すぎますが、「『ネットワークアクセスの制限』のトピックに詳細を追加する」は具体的で実行しやすいです。 | ||
- 新しいイシューに関連していて似たようなイシューが存在していないか探してください。 | ||
- 新しいイシューがほかのイシューやプルリクエストに関連している場合は、該当する URL 全文を記載するか、`#` をつけてイシュー番号やプルリクエスト番号を記述してください。例えば、`Introduced by #987654` です。 | ||
- [Code of Conduct](https://github.com/open-telemetry/community/blob/main/code-of-conduct.md) に従ってください。ほかのコントリビューターを尊重しましょう。「このドキュメントはひどい」のような発言は、有益でも礼儀正しくもありません。 |