From 4e0257a8fce48c21608e56c88772e1562463e9f7 Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Tue, 4 Feb 2025 21:01:35 +0900
Subject: [PATCH 01/11] docs: translated contributing/pull-requests into ja

---
 content/ja/docs/contributing/pull-requests.md | 467 ++++++++++++++++++
 static/refcache.json                          |   4 +
 2 files changed, 471 insertions(+)
 create mode 100644 content/ja/docs/contributing/pull-requests.md

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
new file mode 100644
index 000000000000..bc4a0253fa54
--- /dev/null
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -0,0 +1,467 @@
+---
+title: コンテンツの提出
+description: GitHub UI またはローカルのフォークを利用して、新しいコンテンツまたはコンテンツの変更を提出する方法を学びます
+aliases: [new-content]
+weight: 15
+default_lang_commit: 99f0ae5760038d51f9e9eb376bb428a2caca8167
+---
+
+新しいドキュメントの内容を追加したり、既存のコンテンツの改善をするには、[プルリクエスト][PR] （PR）を提出してください。
+
+- もし変更が小さかったり、自身が Git に慣れていなかったら、[GitHub を使用した変更](#changes-using-github)を参照しページの編集方法を学んでください。
+- もし変更が大きければ、[ローカルのフォークから作業する](#fork-the-repo)を参照し、ローカルのコンピュータから変更を行う方法を学んでください。
+
+{{% alert title="ヒント: Draft ステータス" %}}
+
+コンテンツがレビューの準備ができていないことをメンテナーに知らせるために、プルリクエストのステータスを **Draft** にしてください。
+メンテナーは、Draft ステータスを解除するまでコンテンツを完全にレビューしませんが、コメントや高レベルのレビューを行うことがあります。
+
+{{% /alert %}}
+
+以下の図は新しいドキュメントにコントリビュートする方法を示しています。
+
+```mermaid
+flowchart LR
+    subgraph first[コントリビュートする方法]
+    direction TB
+       T[ ] -.-
+       B[GitHub でフォークする] --- C[マークダウンでドキュメントを作成する<br>Hugo でサイトをビルドする]
+       C --- D[フォーク先にソースコードを push する]
+       D --- E[プルリクエストを公開する]
+       E --- F[CNCF CLA に署名する]
+    end
+
+classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px;
+classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold
+classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000
+class A,B,C,D,E,F,G,H grey
+class S,T spacewhite
+class first,second white
+```
+
+_図 1. 新しいコンテンツにコントリビュートする。_
+
+## GitHub を使用した変更 {#changes-using-github}
+
+もし、Git のワークフローをあまり慣れていなければ、プルリクエストを作成して提出するより簡単な方法があります。
+図 2 は手順の概要を示しており、詳細はこの後に続きます。
+
+{{% alert title="Contributor License Agreement (CLA)" color=warning %}}
+
+すべてのコントリビューターは、変更が承認されてマージされる前に、[コントリビューター ライセンス契約 (CLA)][CLA] に署名する必要があります。
+
+[CLA]: ../prerequisites/#cla
+
+{{% /alert %}}
+
+```mermaid
+flowchart LR
+A([fa:fa-user 新しい<br>コントリビューター]) --- id1[(open-telemetry/opentelemetry.io<br>GitHub)]
+subgraph tasks[GitHub を使用した変更]
+direction TB
+    0[ ] -.-
+    1[1\. ページを編集] --> 2[2\. GitHub マークダウンエディターを利用して変更を加える]
+    2 --> 3[3\. Propose file change を記入]
+
+end
+subgraph tasks2[ ]
+direction TB
+4[4\. Propose file change を選択] --> 5[5\. Create pull request を選択] --> 6[6\. Open a pull request を記入]
+6 --> 7[7\. Create pull request を選択]
+end
+
+id1 --> tasks --> tasks2
+
+classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px;
+classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold
+classDef k8s fill:#326ce5,stroke:#fff,stroke-width:1px,color:#fff;
+classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000
+class A,1,2,3,4,5,6,7 grey
+class 0 spacewhite
+class tasks,tasks2 white
+class id1 k8s
+```
+
+_図 2. GitHub を利用した PR の公開手順。_
+
+1. 問題を見つけたページ上で、右側のナビゲーションパネルにある **ページの編集** のオプションを選択してください。
+
+1. プロジェクトのメンバーでない場合、GitHub でリポジトリのフォークの作成を提案されます。**Fork this repository**を選択してください。
+
+1. GitHub のエディターで、変更を加えます。
+
+1. **Propose file change** フォームに記入してください。
+
+1. **Propose file change** を選択します。
+
+1. **Create Pull request** を選択します。
+
+1. **Open a pull request** 画面に表示されます。あなたの説明はレビュアーが理解するのに役立ちます。
+
+1. **Create pull request**を選択してください。
+
+プルリクエストをマージする前に、OpenTelemetry コミュニティメンバーはレビューしてアプルーブします。
+
+レビュアーから変更を求められた場合。
+
+1. **File changed**タブに移動してください。
+1. プルリクエストによって変更されたファイルのいずれかで、鉛筆（編集）アイコンを選択します。
+1. 求めら得た変更を加えください。 コードの提案があれば、適用してください。
+1. 変更をコミットしてください。
+
+レビューが完了したら、レビュアーは PR をマージして変更が数分後に反映されます。
+
+{{% alert title="Tip" %}}
+
+プルリクエストに `/fix:format` とコメントすると、フォーマットの問題を自動的にチェックするトリガーが起動します。
+
+{{% /alert %}}
+
+## ローカルのフォークから作業する {#fork-the-repo}
+
+Git に慣れている場合もしくは、変更が数行以上の場合は、ローカルのフォークから作業してください。
+
+[git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) がパソコンにインストール済みであることを確認してください。
+Git のユーザーインターフェースも利用できます。
+
+図 3 は、ローカルのフォークから作業するときに従う手順を示しています。詳細はそれぞれの手順に従ってください。
+
+```mermaid
+flowchart LR
+1[open-telemetry/opentelemetry<br>repository をフォーク] --> 2[ローカルのクローンを作成<br>アップストリームを設定]
+subgraph changes[変更]
+direction TB
+S[ ] -.-
+3[ブランチを作成<br>例 my_new_branch] --> 3a[テキストエディター<br>を使用した変更の追加] --> 4["Hugo を使用した<br>変更のプレビュー<br>(localhost:1313)"]
+end
+subgraph changes2[コミット / プッシュ]
+direction TB
+T[ ] -.-
+5[変更をコミット] --> 6[origin/my_new_branch<br>にコミットをプッシュ]
+end
+
+2 --> changes --> changes2
+
+classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px;
+classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold
+classDef k8s fill:#326ce5,stroke:#fff,stroke-width:1px,color:#fff;
+classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000
+class 1,2,3,3a,4,5,6 grey
+class S,T spacewhite
+class changes,changes2 white
+```
+
+_図 3. ローカルのフォークで作業して変更を追加。_
+
+### opentelemetry.io リポジトリをフォークする {#fork-the-opentelemetryio-repository}
+
+1. [`opentelemetry.io`](https://github.com/open-telemetry/opentelemetry.io/) リポジトリに移動してください。
+1. **フォーク**を選択してください。
+
+### ローカルのクローンを作成し、アップストリームを設定してください {#create-a-local-clone-and-set-the-upstream}
+
+1. ターミナルウィンドウで、フォークをクローンし、必要なものをインストールしてください。
+
+   ```shell
+   git clone git@github.com:<your_github_username>/opentelemetry.io.git
+   cd opentelemetry.io
+   npm install
+   ```
+
+1. `open-telemetry/opentelemetry.io` リポジトリを `upstream` リモートに設定。
+
+   ```shell
+   git remote add upstream https://github.com/open-telemetry/opentelemetry.io.git
+   ```
+
+1. `origin` and `upstream` リポジトリの確認。
+
+   ```shell
+   git remote -v
+   ```
+
+   出力は以下のようになります。
+
+   ```none
+   origin	git@github.com:<your_github_username>/opentelemetry.io.git (fetch)
+   origin	git@github.com:<your_github_username>/opentelemetry.io.git (push)
+   upstream	https://github.com/open-telemetry/opentelemetry.io.git (fetch)
+   upstream	https://github.com/open-telemetry/opentelemetry.io.git (push)
+   ```
+
+1. フォークの `origin/main` と `open-telemetry/opentelemetry.io`'s `upstream/main` からコミットをフェッチ。
+
+   ```shell
+   git fetch origin
+   git fetch upstream
+   ```
+
+   これにより、変更を加える前にローカルリポジトリが最新の状態であることを確認できます。
+   フォークをアップストリームと同期させるために、定期的にアップストリームの変更をオリジンにプッシュしてください。
+
+### ブランチを作成 {#create-a-branch}
+
+1. 新しいブランチを作成します。 この例はベースブランチが `upstream/main` であると想定しています。
+
+   ```shell
+   git checkout -b <my_new_branch> upstream/main
+   ```
+
+1. コードエディターまたはテキストエディターを使用して変更を加えてください。
+
+いつでも、`git status` コマンドを使用して、どのファイルが変更したか確認できます。
+
+### 変更のコミット {#commit-your-changes}
+
+プルリクエストを提出する準備ができたら、変更をコミットしてください。
+
+1. ローカルリポジトリで、コミットが必要なファイルを確認してください。
+
+   ```shell
+   git status
+   ```
+
+   出力は次のようになります。
+
+   ```none
+   On branch <my_new_branch>
+   Your branch is up to date with 'origin/<my_new_branch>'.
+
+   Changes not staged for commit:
+   (use "git add <file>..." to update what will be committed)
+   (use "git checkout -- <file>..." to discard changes in working directory)
+
+   modified:   content/en/docs/file-you-are-editing.md
+
+   no changes added to commit (use "git add" and/or "git commit -a")
+   ```
+
+1. **Changes not staged for commit** のリストされているファイルをコミットしてください。
+
+   ```shell
+   git add <your_file_name>
+   ```
+
+   これを各ファイルに対して繰り返してください。
+
+1. すべてのファイルを追加した後に、 コミットを作成してください。
+
+   ```shell
+   git commit -m "Your commit message"
+   ```
+
+1. ローカルブランチと新しいコミットをリモートのフォークにプッシュしてください。
+
+   ```shell
+   git push origin <my_new_branch>
+   ```
+
+1. 変更がプッシュされると、GitHub が PR を作成できることを知らせます。
+
+### フォークからプルリクエストを公開する {#open-a-pr}
+
+図 4 はフォークから [opentelemetry.io](https://github.com/open-telemetry/opentelemetry.io) への PR を開く手順を示しています。
+
+```mermaid
+flowchart LR
+subgraph first[ ]
+direction TB
+1[1\. opentelemetry.io リポジトリに移動] --> 2[2\. New Pull Request を選択]
+2 --> 3[3\. compare across forks を選択]
+3 --> 4[4\. head repository のドロップダウンメニューから<br>自身のフォークを選択]
+end
+subgraph second [ ]
+direction TB
+5[5\. compare のドロップダウンメニューから<br>自身のブランチを選択] --> 6[6\. Create Pull Request を選択]
+6 --> 7[7\. PR に説明を追加]
+7 --> 8[8\. Create pull request を選択]
+end
+
+first --> second
+
+classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px;
+classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold
+class 1,2,3,4,5,6,7,8 grey
+class first,second white
+```
+
+_図 4. フォークから、PR を公開する手順_
+[opentelemetry.io](https://github.com/open-telemetry/opentelemetry.io).
+
+1. Web ブラウザで [`opentelemetry.io`](https://github.com/open-telemetry/opentelemetry.io) リポジトリにアクセスしてください。
+1. **New Pull Request** を作成してください。
+1. **compare across forks** を選択してください。
+1. **head repository** ドロップダウンメニューから、あなたのフォークを選択してください。
+1. ドロップダウンメニューの **compare** から、あなたのブランチを選択してください。
+1. **Create Pull Request** を選択してください。
+1. プルリクエストの説明を追加してください。
+
+   - **タイトル** (50 文字未満): 変更の意図を要約してください。
+   - **説明**: 変更を詳細に記述してください。
+
+     - GitHub イシューに関連する場合、`Fixes #12345` や `Closes #12345` を説明に記述することで、PR のマージしたあとに GitHub の自動化が該当イシューをクローズします。 他の関連する PR がある場合もリンクしてください。
+     - 特定のことに対してアドバイスを求める場合、説明にレビュアーが考えて欲しい質問を含めてください。
+
+1. **Create pull request** ボタンを選択してください。
+
+プルリクエストは、[Pull requests](https://github.com/open-telemetry/opentelemetry.io/pulls) で確認できます。
+
+PR を公開した後に、自動テストの実行と [Netlify](https://www.netlify.com/) を使用したプレビューのデプロイを試みます。
+
+- Netlify ビルドが失敗した場合、詳細な情報のために **Details** を選択してください。
+- Netify のビルドが成功した場合、**Details** を選択して、変更が適用された OpenTelemetry のウェブサイトのステージングバージョンを開いてください。 これがレビュアーが変更を確認する方法です。
+
+他のチェックも同様に失敗している可能性があります。[全ての PR チェック](../pr-checks) を参照してください。
+
+### 内容の問題を自動的に修正する {#fix-content-issues-automatically}
+
+リポジトリに変更を提出するまえに、以下のコマンドを実行して (i) 報告された問題の対応し、(ii) スクリプトによって変更されたファイルのコミットをしてください。
+
+```sh
+npm run test-and-fix
+```
+
+ファイルに対して、テストとすべての問題の修正を分割して実行するには、以下を実行してください。
+
+```sh
+npm run test    # ファイルを更新せずにチェックのみを実行します
+npm run fix:all # ファイルを更新する場合があります。
+```
+
+利用可能な NPM スクリプトのリストを表示するには、`npm run` を実行してください。
+プルリクエストのチェックとエラーの自動修正の詳細は、[PR checks](../pr-checks) を参照してください。
+
+### 変更をローカルでプレビューする {#preview-locally}
+
+変更のプッシュまたはプルリクエストの公開の前に、ローカルでプレビューしてください。
+プレビューはビルドエラーとマークダウンのフォーマットの問題を検出できます。
+
+Hugo をローカルでビルドと提供するには、以下のコマンドを実行してください。
+
+```shell
+npm run serve
+```
+
+Web ブラウザで `http://localhost:1313` に移動してローカルプレビューを確認してください。
+Hugo は変更を監視し、必要に応じてサイトをリビルドします。
+
+ローカルの Hugo インスタンスを停止するには、ターミナルにもどって `Ctrl+C` を入力するか、ターミナルを閉じてください。
+
+### サイトデプロイと PR プレビュー {#site-deploys-and-pr-previews}
+
+PR を提出したら、Netlify は [deploy preview][] を作成し、変更をレビューできます。
+PR がマージされると、Netlify はプロダクションサーバーに更新されたサイトを本番サーバーにデプロイします。
+
+> **Note**: PR プレビューには ドラフトページ が含まれますが、本番ビルドには含まれません。
+
+デプロイログなどを確認するには、プロジェクトの [dashboard][] を確認してください。
+Netlify ログインが必要です。
+
+### PR ガイドライン {#pr-guidelines}
+
+PR がマージされる前に、レビューと編集を数回繰り返すことがあります。
+このプロセスをできるだけ簡単にするために、以下のガイドラインに従ってください。
+
+- もしあなたの PR が簡単な修正でない場合は、**フォークから作業**してください。 リポジトリの上部にある [Fork](https://github.com/open-telemetry/opentelemetry.io/fork) ボタンをクリックし、フォークをローカルにクローンしてください。準備ができたら、アップストリームリポジトリに PR を作成してください。
+- あたなたのフォークの **`main` ブランチから作業をせずに**、PR 専用のブランチを作成してください。
+- メンテナーが[あなたのプルリクエストに変更を加えられること](https://docs.github.com/ja/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork)を確認してください。
+
+### レビュアーからの変更 {#changes-from-reviewers}
+
+レビュアーはあなたのプルリクエストにコミットすることがあります。
+ほかの変更を加える前に、それらのコミットをフェッチしてください。
+
+1. リモートフォークからコミットをフェッチして、作業中のブランチをリベースしてください。
+
+   ```shell
+   git fetch origin
+   git rebase origin/<your-branch-name>
+   ```
+
+1. リベースしたあとに、フォーク先にあなたの変更をフォースプッシュしてください。
+
+   ```shell
+   git push --force-with-lease origin <your-branch-name>
+   ```
+
+コンフリクトは GitHub UI からも解決できます。
+
+### マージのコンフリクトとリベース {#merge-conflicts-and-rebasing}
+
+別のコントリビューターが別の PR で同じファイルに変更をコミットすると、マージコンフリクトが発生する可能性があります。
+あなたの PR ですべてのマージコンフリクトを解決する必要があります。
+
+1. フォークを更新して、ローカルブランチをリベースしてください。
+
+   ```shell
+   git fetch origin
+   git rebase origin/<your-branch-name>
+   ```
+
+   フォークに変更をフォースプッシュしてください。
+
+   ```shell
+   git push --force-with-lease origin <your-branch-name>
+   ```
+
+1. `open-telemetry/opentelemetry.io` の `upstream/main` から変更をフェッチして、あなたのブランチをリベースしてください。
+
+   ```shell
+   git fetch upstream
+   git rebase upstream/main
+   ```
+
+1. リベースの結果を確認してください。
+
+   ```shell
+   git status
+   ```
+
+   これにより、多くのファイルがコンフリクトとしてマークされます。
+
+1. コンフリクトが発生した各ファイルを開き、コンフリクトマーカー（`>>>`、`<<<` そして `===`） を探してください。 コンフリクトを解消してコンフリクトマーカーを削除してください。
+
+   詳細は、[How conflicts are presented](https://git-scm.com/docs/git-merge#_how_conflicts_are_presented) を確認してください。
+
+1. ファイルをチェンジセットに追加してください。
+
+   ```shell
+   git add <filename>
+   ```
+
+1. リベースを続けてください。
+
+   ```shell
+   git rebase --continue
+   ```
+
+1. ステップ 2 から 5 を必要に応じて繰り返してください。
+
+   すべてのコミットを適用した後、`git status` コマンドはリベースが完了したことを示します。
+
+1. ブランチをあなたのフォークにフォースプッシュしてください。
+
+   ```shell
+   git push --force-with-lease origin <your-branch-name>
+   ```
+
+   プルリクエストにはもうコンフリクトが表示されません。
+
+### マージの要件 {#merge-requirements}
+
+プルリクエストは、以下の条件を満たしたときにマージされます。
+
+- 承認者、メンテナー、技術委員会メンバー、または専門家によるすべてのレビューが "Approved" ステータスであること。
+- 解決していない会話がないこと。
+- 最低 1 人の承認者によって承認されていること。
+- 失敗している PR チェックがないこと。
+- PR ブランチがベースブランチと最新の状態であること。
+
+> **重要**
+>
+> PR チェックの失敗についてあまり心配しないでください。
+> コミュニティメンバーが修正方法を教えたり、代わりに修正したりしてくれます。
+
+[dashboard]: https://app.netlify.com/sites/opentelemetry/overview
+[deploy preview]: https://www.netlify.com/blog/2016/07/20/introducing-deploy-previews-in-netlify/
+[PR]: https://docs.github.com/en/pull-requests
diff --git a/static/refcache.json b/static/refcache.json
index cd2d1815c0fc..fed83ecb505a 100644
--- a/static/refcache.json
+++ b/static/refcache.json
@@ -1159,6 +1159,10 @@
     "StatusCode": 206,
     "LastSeen": "2024-10-30T15:12:28.788328409Z"
   },
+  "https://docs.github.com/ja/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork": {
+    "StatusCode": 206,
+    "LastSeen": "2025-02-09T09:07:44.563811+09:00"
+  },
   "https://docs.google.com/document/d/1-23Sf7-xZK3OL5Ogv2pK0NP9YotlSa0PKU9bvvtQwp8": {
     "StatusCode": 200,
     "LastSeen": "2024-08-15T15:44:20.868165+02:00"

From a56d14e64f12c4ae42b20d06abbf6236a7e9c46d Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 07:37:43 +0900
Subject: [PATCH 02/11] refactor: turn `allowing chnages to a pull request
 branch created from a fork` into param

---
 content/en/docs/contributing/pull-requests.md | 4 ++--
 content/ja/docs/contributing/pull-requests.md | 2 +-
 hugo.yaml                                     | 3 +++
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/content/en/docs/contributing/pull-requests.md b/content/en/docs/contributing/pull-requests.md
index 5d518c337847..d6583f2b6577 100644
--- a/content/en/docs/contributing/pull-requests.md
+++ b/content/en/docs/contributing/pull-requests.md
@@ -405,8 +405,8 @@ we ask that you adhere to the following:
   PR with the upstream repository.
 - **Do not work from the `main`** branch of your fork, but create a PR-specific
   branch.
-- Ensure that maintainers are
-  [allowed to apply changes to your pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork).
+- Ensure that maintainers are [allowed to apply changes to your pull
+  request]({{% param allowing_changes_to_a_pull_request_branch_created_from_a_fork %}}).
 
 ### Changes from reviewers
 
diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index bc4a0253fa54..c7e63d2f5a45 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -364,7 +364,7 @@ PR がマージされる前に、レビューと編集を数回繰り返すこ
 
 - もしあなたの PR が簡単な修正でない場合は、**フォークから作業**してください。 リポジトリの上部にある [Fork](https://github.com/open-telemetry/opentelemetry.io/fork) ボタンをクリックし、フォークをローカルにクローンしてください。準備ができたら、アップストリームリポジトリに PR を作成してください。
 - あたなたのフォークの **`main` ブランチから作業をせずに**、PR 専用のブランチを作成してください。
-- メンテナーが[あなたのプルリクエストに変更を加えられること](https://docs.github.com/ja/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork)を確認してください。
+- メンテナーが[あなたのプルリクエストに変更を加えられること]({{% param allowing_changes_to_a_pull_request_branch_created_from_a_fork %}})を確認してください。
 
 ### レビュアーからの変更 {#changes-from-reviewers}
 
diff --git a/hugo.yaml b/hugo.yaml
index c85798d47564..98de9c57539f 100644
--- a/hugo.yaml
+++ b/hugo.yaml
@@ -28,6 +28,8 @@ languages:
     languageName: 日本語 (Japanese)
     params:
       description: OpenTelemetryプロジェクト公式サイト
+      allowing_changes_to_a_pull_request_branch_created_from_a_fork: https://docs.github.com/ja/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork
+
   pt: # cSpell:ignore Português Projeto
     languageName: Português
     languageCode: pt-BR
@@ -102,6 +104,7 @@ params:
   github_repo: https://github.com/open-telemetry/opentelemetry.io
   github_branch: main
   gcs_engine_id: 015faf7de29c34606
+  allowing_changes_to_a_pull_request_branch_created_from_a_fork: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork
 
   ## Social media image path, such as Open Graph's og:image
   #

From c4de6a68e66c6b49b070260ff6aefbb64feac6ec Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 08:34:47 +0900
Subject: [PATCH 03/11] Revert "refactor: turn `allowing chnages to a pull
 request branch created from a fork` into param"

This reverts commit 6114eb19d71cbc769a77c9ee1135afa8da22e809.
---
 content/en/docs/contributing/pull-requests.md | 4 ++--
 content/ja/docs/contributing/pull-requests.md | 2 +-
 hugo.yaml                                     | 3 ---
 3 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/content/en/docs/contributing/pull-requests.md b/content/en/docs/contributing/pull-requests.md
index d6583f2b6577..5d518c337847 100644
--- a/content/en/docs/contributing/pull-requests.md
+++ b/content/en/docs/contributing/pull-requests.md
@@ -405,8 +405,8 @@ we ask that you adhere to the following:
   PR with the upstream repository.
 - **Do not work from the `main`** branch of your fork, but create a PR-specific
   branch.
-- Ensure that maintainers are [allowed to apply changes to your pull
-  request]({{% param allowing_changes_to_a_pull_request_branch_created_from_a_fork %}}).
+- Ensure that maintainers are
+  [allowed to apply changes to your pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork).
 
 ### Changes from reviewers
 
diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index c7e63d2f5a45..bc4a0253fa54 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -364,7 +364,7 @@ PR がマージされる前に、レビューと編集を数回繰り返すこ
 
 - もしあなたの PR が簡単な修正でない場合は、**フォークから作業**してください。 リポジトリの上部にある [Fork](https://github.com/open-telemetry/opentelemetry.io/fork) ボタンをクリックし、フォークをローカルにクローンしてください。準備ができたら、アップストリームリポジトリに PR を作成してください。
 - あたなたのフォークの **`main` ブランチから作業をせずに**、PR 専用のブランチを作成してください。
-- メンテナーが[あなたのプルリクエストに変更を加えられること]({{% param allowing_changes_to_a_pull_request_branch_created_from_a_fork %}})を確認してください。
+- メンテナーが[あなたのプルリクエストに変更を加えられること](https://docs.github.com/ja/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork)を確認してください。
 
 ### レビュアーからの変更 {#changes-from-reviewers}
 
diff --git a/hugo.yaml b/hugo.yaml
index 98de9c57539f..c85798d47564 100644
--- a/hugo.yaml
+++ b/hugo.yaml
@@ -28,8 +28,6 @@ languages:
     languageName: 日本語 (Japanese)
     params:
       description: OpenTelemetryプロジェクト公式サイト
-      allowing_changes_to_a_pull_request_branch_created_from_a_fork: https://docs.github.com/ja/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork
-
   pt: # cSpell:ignore Português Projeto
     languageName: Português
     languageCode: pt-BR
@@ -104,7 +102,6 @@ params:
   github_repo: https://github.com/open-telemetry/opentelemetry.io
   github_branch: main
   gcs_engine_id: 015faf7de29c34606
-  allowing_changes_to_a_pull_request_branch_created_from_a_fork: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork
 
   ## Social media image path, such as Open Graph's og:image
   #

From 94b48249ef6933181fef0f9c16c2584d27932eba Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 16:18:44 +0900
Subject: [PATCH 04/11] refactor: improve readability in ja

---
 content/ja/docs/contributing/pull-requests.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index bc4a0253fa54..30bdd20edfa4 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -14,7 +14,7 @@ default_lang_commit: 99f0ae5760038d51f9e9eb376bb428a2caca8167
 {{% alert title="ヒント: Draft ステータス" %}}
 
 コンテンツがレビューの準備ができていないことをメンテナーに知らせるために、プルリクエストのステータスを **Draft** にしてください。
-メンテナーは、Draft ステータスを解除するまでコンテンツを完全にレビューしませんが、コメントや高レベルのレビューを行うことがあります。
+メンテナーは、Draft ステータスを解除するまでコンテンツを完全なレビューはしませんが、コメントや高レベルのレビューを行うことがあります。
 
 {{% /alert %}}
 

From c6891b0eca740476bef8a2cdb1dcf6b9740309cf Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 16:20:44 +0900
Subject: [PATCH 05/11] =?UTF-8?q?fix:=20translate=20`Markdown`=20into=20`?=
 =?UTF-8?q?=E3=83=9E=E3=83=BC=E3=82=AF=E3=83=80=E3=82=A6=E3=83=B3`?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Because it is a function of GitHub UI, translaters consider that these words should be English.
---
 content/ja/docs/contributing/pull-requests.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index 30bdd20edfa4..943bed80a8bf 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -25,7 +25,7 @@ flowchart LR
     subgraph first[コントリビュートする方法]
     direction TB
        T[ ] -.-
-       B[GitHub でフォークする] --- C[マークダウンでドキュメントを作成する<br>Hugo でサイトをビルドする]
+       B[GitHub でフォークする] --- C[Markdownでドキュメントを作成する<br>Hugo でサイトをビルドする]
        C --- D[フォーク先にソースコードを push する]
        D --- E[プルリクエストを公開する]
        E --- F[CNCF CLA に署名する]
@@ -60,7 +60,7 @@ A([fa:fa-user 新しい<br>コントリビューター]) --- id1[(open-telemetry
 subgraph tasks[GitHub を使用した変更]
 direction TB
     0[ ] -.-
-    1[1\. ページを編集] --> 2[2\. GitHub マークダウンエディターを利用して変更を加える]
+    1[1\. ページを編集] --> 2[2\. GitHub Markdownエディターを利用して変更を加える]
     2 --> 3[3\. Propose file change を記入]
 
 end

From d45524284b752bfe3e5dd71c71360fc4b27605d6 Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 16:22:42 +0900
Subject: [PATCH 06/11] refactor: adding full words of CLA to improve
 readability

---
 content/ja/docs/contributing/pull-requests.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index 943bed80a8bf..a028310d5fc9 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -48,7 +48,7 @@ _図 1. 新しいコンテンツにコントリビュートする。_
 
 {{% alert title="Contributor License Agreement (CLA)" color=warning %}}
 
-すべてのコントリビューターは、変更が承認されてマージされる前に、[コントリビューター ライセンス契約 (CLA)][CLA] に署名する必要があります。
+すべてのコントリビューターは、変更が承認されてマージされる前に、[コントリビューターライセンス契約（Contributor License Agreement、CLA）][CLA] に署名する必要があります。
 
 [CLA]: ../prerequisites/#cla
 

From 46232b4393c5fb3cc6ef81845293fde5d76c4c04 Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 16:23:27 +0900
Subject: [PATCH 07/11] =?UTF-8?q?fix:=20turn=20`=E3=82=A2=E3=83=97?=
 =?UTF-8?q?=E3=83=AB=E3=83=BC=E3=83=96`=20into=20`=E6=89=BF=E8=AA=8D`=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/pull-requests.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index a028310d5fc9..47863e2a4eaf 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -100,7 +100,7 @@ _図 2. GitHub を利用した PR の公開手順。_
 
 1. **Create pull request**を選択してください。
 
-プルリクエストをマージする前に、OpenTelemetry コミュニティメンバーはレビューしてアプルーブします。
+プルリクエストをマージする前に、OpenTelemetry コミュニティメンバーはレビューして承認します。
 
 レビュアーから変更を求められた場合。
 

From c82a538a0d607c8ce3eccd84a096ad295e92f181 Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 16:24:09 +0900
Subject: [PATCH 08/11] fix: missing remaining a English word

---
 content/ja/docs/contributing/pull-requests.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index 47863e2a4eaf..7e3ca746f6c8 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -174,7 +174,7 @@ _図 3. ローカルのフォークで作業して変更を追加。_
    git remote add upstream https://github.com/open-telemetry/opentelemetry.io.git
    ```
 
-1. `origin` and `upstream` リポジトリの確認。
+1. `origin` と `upstream` リポジトリの確認。
 
    ```shell
    git remote -v

From 53a361d72fb67f7cacab108977b833883074bc94 Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 16:24:49 +0900
Subject: [PATCH 09/11] fix: missing remaining a English word

---
 content/ja/docs/contributing/pull-requests.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index 7e3ca746f6c8..0d99ad85d474 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -189,7 +189,7 @@ _図 3. ローカルのフォークで作業して変更を追加。_
    upstream	https://github.com/open-telemetry/opentelemetry.io.git (push)
    ```
 
-1. フォークの `origin/main` と `open-telemetry/opentelemetry.io`'s `upstream/main` からコミットをフェッチ。
+1. フォークの `origin/main` と `open-telemetry/opentelemetry.io` の `upstream/main` からコミットをフェッチ。
 
    ```shell
    git fetch origin

From 1288b24264e133c39ba8d0f84d39b01c644c33ae Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 16:25:51 +0900
Subject: [PATCH 10/11] fix: typo of `Netify` to `Netlify`

---
 content/ja/docs/contributing/pull-requests.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index 0d99ad85d474..a2d223573b73 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -309,7 +309,7 @@ _図 4. フォークから、PR を公開する手順_
 PR を公開した後に、自動テストの実行と [Netlify](https://www.netlify.com/) を使用したプレビューのデプロイを試みます。
 
 - Netlify ビルドが失敗した場合、詳細な情報のために **Details** を選択してください。
-- Netify のビルドが成功した場合、**Details** を選択して、変更が適用された OpenTelemetry のウェブサイトのステージングバージョンを開いてください。 これがレビュアーが変更を確認する方法です。
+- Netlify のビルドが成功した場合、**Details** を選択して、変更が適用された OpenTelemetry のウェブサイトのステージングバージョンを開いてください。 これがレビュアーが変更を確認する方法です。
 
 他のチェックも同様に失敗している可能性があります。[全ての PR チェック](../pr-checks) を参照してください。
 

From 2463e4037df442d54d57db9faabe5c1260919a1b Mon Sep 17 00:00:00 2001
From: Msksgm <msksgm3124@gmail.com>
Date: Mon, 10 Feb 2025 16:26:22 +0900
Subject: [PATCH 11/11] =?UTF-8?q?fix:=20`=E5=85=A8=E3=81=A6`=20to=20`?=
 =?UTF-8?q?=E3=81=99=E3=81=B9=E3=81=A6`?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 content/ja/docs/contributing/pull-requests.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/ja/docs/contributing/pull-requests.md b/content/ja/docs/contributing/pull-requests.md
index a2d223573b73..445f6d501ef9 100644
--- a/content/ja/docs/contributing/pull-requests.md
+++ b/content/ja/docs/contributing/pull-requests.md
@@ -311,7 +311,7 @@ PR を公開した後に、自動テストの実行と [Netlify](https://www.net
 - Netlify ビルドが失敗した場合、詳細な情報のために **Details** を選択してください。
 - Netlify のビルドが成功した場合、**Details** を選択して、変更が適用された OpenTelemetry のウェブサイトのステージングバージョンを開いてください。 これがレビュアーが変更を確認する方法です。
 
-他のチェックも同様に失敗している可能性があります。[全ての PR チェック](../pr-checks) を参照してください。
+他のチェックも同様に失敗している可能性があります。[すべての PR チェック](../pr-checks) を参照してください。
 
 ### 内容の問題を自動的に修正する {#fix-content-issues-automatically}