Skip to content

Commit

Permalink
docs: translated contributing/issues into ja
Browse files Browse the repository at this point in the history
  • Loading branch information
Msksgm committed Feb 5, 2025
1 parent 7281afc commit b32129d
Showing 1 changed file with 75 additions and 0 deletions.
75 changes: 75 additions & 0 deletions content/ja/docs/contributing/issues.md
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) に従ってください。ほかのコントリビューターを尊重しましょう。「このドキュメントはひどい」のような発言は、有益でも礼儀正しくもありません。

0 comments on commit b32129d

Please sign in to comment.