From f2a2bc9a5ff43d26da769e084a8c4d856f67502e Mon Sep 17 00:00:00 2001 From: Msksgm Date: Mon, 3 Feb 2025 21:36:54 +0900 Subject: [PATCH 1/3] docs: translated contributing/issues into ja --- content/ja/docs/contributing/issues.md | 75 ++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 content/ja/docs/contributing/issues.md diff --git a/content/ja/docs/contributing/issues.md b/content/ja/docs/contributing/issues.md new file mode 100644 index 000000000000..2195e187c1c9 --- /dev/null +++ b/content/ja/docs/contributing/issues.md @@ -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: 24146bd1368e4c6082c7d6077efd29dba0d51055 +--- + +## 既存のイシューの修正 {#fixing-an-existing-issue} + +OTel を改善するための最も良い方法の 1 つは、既存のイシューを修正することです。 + +1. [issues]({{% param _issues %}}) のリストを参照してください。 +2. 作業したいイシューを選択してください。短時間で修正できるものが理想です。 + + + + {{% alert title="最初のコントリビュートですか？" %}} + + 以下のラベルのイシューを選択してください。 + + - [Good first issue] + - [Help wanted] + + + > **NOTE**: メンターシップやオンボーディングプロセスの一部でない限り、私たちは、[OpenTelemetry organization][org] にまだコントリビュートしたことがない人に**イシューをアサインしません**。 + {.mt-3} + + + [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)。 + +## イシューの報告 {#reporting-an-issue} + +エラーに気が付いたり既存の内容に改善を提案したい場合は、イシューを開いてください。 + +1. 任意のドキュメントの**ドキュメントのissueを作成**のリンクをクリックしてください。これにより、ヘッダーがあらかじめ入力された GitHub のイシューページにリダイレクトされます。 +2. 問題点または改善の提案を説明してください。できるだけ多くの詳細を提供してください。 +3. **作成** をクリックしてください。 + +提出した後に、あなたのイシューを時々確認するか、GitHub の通知をオンにしてください。 +メンテナーと承認者が反応するまで、数日かかる場合があります。 +レビュアーやほかのコミュニティメンバーがイシューに対処する前に質問する場合があります。 + +## 新しいコンテンツや機能の提案 {#suggesting-new-content-or-features} + +新しいコンテンツや機能のアイデアを持っているが、どこに配置すべきかわからない場合、イシューに提出できます。 +バグとセキュリティの脆弱性も同様に報告できます。 + +1. [GitHub](https://github.com/open-telemetry/opentelemetry.io/issues/new/) に行って **Issues** タブ内の **New issue** を選択してください。 +2. 要望または疑問に最も適したイシューの種類を選択してください。 +3. テンプレートに入力してください。 +4. イシューを提出してください。 + +### 優れたイシューの作成方法 {#how-to-file-great-issues} + +イシューを作成する際には、以下の点に注意してください。 +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) に従ってください。ほかのコントリビューターを尊重しましょう。「このドキュメントはひどい」のような発言は、有益でも礼儀正しくもありません。 From bbc24aab4cb88068de0ffa86a7a4a373dd36627d Mon Sep 17 00:00:00 2001 From: Msksgm Date: Mon, 10 Feb 2025 16:03:32 +0900 Subject: [PATCH 2/3] fix: delete the en sentence --- content/ja/docs/contributing/issues.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/ja/docs/contributing/issues.md b/content/ja/docs/contributing/issues.md index 2195e187c1c9..b8dd5da36324 100644 --- a/content/ja/docs/contributing/issues.md +++ b/content/ja/docs/contributing/issues.md @@ -65,7 +65,6 @@ OTel を改善するための最も良い方法の 1 つは、既存のイシュ ### 優れたイシューの作成方法 {#how-to-file-great-issues} イシューを作成する際には、以下の点に注意してください。 -Keep the following in mind when filing an issue: - 明確な説明を提供してください。何が欠けていて、古くなっていて、間違っていて改善を必要としているのか説明してください。 - ユーザーへの具体的な影響を説明してください。 From 8059b2073c0dab4380c001ed19937b03e67a0f16 Mon Sep 17 00:00:00 2001 From: Msksgm Date: Mon, 10 Feb 2025 16:04:23 +0900 Subject: [PATCH 3/3] =?UTF-8?q?refactor:=20turn=20`=E4=BE=8B=E3=81=88?= =?UTF-8?q?=E3=81=B0`=20into=20`=E3=81=9F=E3=81=A8=E3=81=88=E3=81=B0`=20to?= =?UTF-8?q?=20improve=20readability?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/ja/docs/contributing/issues.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/ja/docs/contributing/issues.md b/content/ja/docs/contributing/issues.md index b8dd5da36324..9892b2a0023e 100644 --- a/content/ja/docs/contributing/issues.md +++ b/content/ja/docs/contributing/issues.md @@ -68,7 +68,7 @@ OTel を改善するための最も良い方法の 1 つは、既存のイシュ - 明確な説明を提供してください。何が欠けていて、古くなっていて、間違っていて改善を必要としているのか説明してください。 - ユーザーへの具体的な影響を説明してください。 -- イシューの範囲は合理的な範囲に制限してください。問題の範囲が大きい場合は、小さなイシューに分割してください。例えば、「セキュリティドキュメントを修正する」は広すぎますが、「『ネットワークアクセスの制限』のトピックに詳細を追加する」は具体的で実行しやすいです。 +- イシューの範囲は合理的な範囲に制限してください。問題の範囲が大きい場合は、小さなイシューに分割してください。たとえば、「セキュリティドキュメントを修正する」は広すぎますが、「『ネットワークアクセスの制限』のトピックに詳細を追加する」は具体的で実行しやすいです。 - 新しいイシューに関連していて似たようなイシューが存在していないか探してください。 -- 新しいイシューがほかのイシューやプルリクエストに関連している場合は、該当する URL 全文を記載するか、`#` をつけてイシュー番号やプルリクエスト番号を記述してください。例えば、`Introduced by #987654` です。 +- 新しいイシューがほかのイシューやプルリクエストに関連している場合は、該当する URL 全文を記載するか、`#` をつけてイシュー番号やプルリクエスト番号を記述してください。たとえば、`Introduced by #987654` です。 - [Code of Conduct](https://github.com/open-telemetry/community/blob/main/code-of-conduct.md) に従ってください。ほかのコントリビューターを尊重しましょう。「このドキュメントはひどい」のような発言は、有益でも礼儀正しくもありません。