qmk_firmware/docs/ja/breaking_changes.md
Takeshi ISHII 2f85f6fbff
[Docs] Japanese translation of breaking_changes*.md (#8576)
* add japanese translation 'docs/ja/breaking_changes.md'

Note: this is cherry-pick from umi-umi's translation in PR #7248

* update ja/breaking_changes.md

* update ja/breaking_changes.md, add ja/breaking_changes_instructions.md

* translating ja/breaking_changes_instructions.md

* translating ja/breaking_changes_instructions.md

* translated ja/breaking_changes_instructions.md

* update ja/breaking_changes.md, ja/breaking_changes_instructions.md

Breaking change の訳語を「破壊的な変更」から「互換性を破る変更」に変更。
ただし、文中の用語としては、Breaking change をそのまま使用するむねドキュメントの導入部で
訳注でしめし、文中では、原語のまま使用する。

* update docs/ja/_summary.md

* Update docs/ja/breaking_changes.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* Update docs/ja/breaking_changes.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* Update docs/ja/breaking_changes.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* Update docs/ja/breaking_changes.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* Update docs/ja/breaking_changes.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* Update docs/ja/breaking_changes.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* Update docs/ja/breaking_changes.md

* update docs/ja/breaking_changes.md

* update docs/ja/breaking_changes.md

* update docs/ja/breaking_changes.md

* update docs/ja/breaking_changes.md

* update docs/ja/breaking_changes.md

* Update docs/ja/breaking_changes_instructions.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* Update docs/ja/breaking_changes_instructions.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* update docs/ja/breaking_changes.md

* Update docs/ja/breaking_changes_instructions.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* Update docs/ja/breaking_changes_instructions.md

* Update docs/ja/breaking_changes_instructions.md

Co-Authored-By: shela <shelaf@users.noreply.github.com>

* update docs/ja/breaking_changes_instructions.md

* update docs/ja/breaking_changes_instructions.md

* The base of the translation of docs/ja/breaking_changes_instructions.md was changed to 0.9.0.

* The base of the translation of docs/ja/breaking_changes.md was changed to 0.9.0.

* Update docs/ja/breaking_changes.md

Co-authored-by: s-show <s1shimz@gmail.com>

* update docs/ja/breaking_changes.md

* Update docs/ja/breaking_changes_instructions.md

Co-authored-by: shela <shelaf@users.noreply.github.com>

* update docs/ja/breaking_changes.md

* update docs/ja/breaking_changes.md

Co-authored-by: umi-umi <57262844+umi-umi@users.noreply.github.com>
Co-authored-by: shela <shelaf@users.noreply.github.com>
Co-authored-by: s-show <s1shimz@gmail.com>
2020-06-21 20:17:16 +09:00

5 KiB

Breaking changes/互換性を破る変更

このドキュメントは QMK の互換性を破る変更(Breaking change) のプロセスについて説明します。 互換性を破る変更とは、互換性がなかったり潜在的な危険が生じるように QMK の動作を変える変更を指します。 ユーザが QMK ツリーを更新しても自分のキーマップが壊れない事を確信できるように、これらの変更を制限します。(訳注:以後、原文のまま Breaking change を用語として使用します。)

Breaking change ピリオドとは、危険な変更、または予想外の変更を QMK へ行なう PR をマージする時のことです。 付随するテスト期間があるため、問題が起きることはまれか、有りえないと確信しています。

過去の Breaking change には何が含まれますか?

次の Breaking change はいつですか?

次の Breaking change は2020年8月29日に予定されています。

重要な日付

  • 2020年 5月30日 - develop が作成されました。毎週リベースされます。
  • 2020年 8月 1日 - develop は新しいPRを取り込みません。
  • 2020年 8月 1日 - テスターの募集。
  • 2020年 8月27日 - masterがロックされ、PR はマージされません。
  • 2020年 8月29日 - developmaster にマージします。
  • 2020年 8月29日 - master のロックが解除されます。PR を再びマージすることができます。

どのような変更が含まれますか?

最新の Breaking change 候補を見るには、breaking_change ラベルを参照してください。 現在から develop が閉じられるまでの間に新しい変更が追加される可能性があり、そのラベルが適用された PR はマージされることは保証されていません。

このラウンドに、あなたの Breaking change を含めたい場合は、breaking_change ラベルを持つ PR を作成し、develop が閉じる前に承認してもらう必要があります。 develop が閉じた後は、新しい Breaking change は受け付けられません。

受け入れの基準:

  • PR が完了し、マージの準備ができている
  • PR が ChangeLog を持つ

チェックリスト

ここでは、Breaking change プロセスを実行する時に使用する様々なプロセスについて説明します。

master から develop をリベースします

これは develop が開いている間、毎週金曜日に実行されます。

プロセス:

cd qmk_firmware
git checkout master
git pull --ff-only
git checkout develop
git rebase master
git push --force

develop ブランチの作成

以前の develop ブランチがマージされた直後に、これが発生します。

  • qmk_firmware git commands
    • git checkout master
    • git pull --ff-only
    • git checkout -b develop
    • Edit readme.md
      • これがテストブランチであることを上部に大きな通知で追加します。
      • このドキュメントへのリンクを含めます
    • git commit -m 'Branch point for <DATE> Breaking Change'
    • git tag breakpoint_<YYYY>_<MM>_<DD>
    • git tag <next_version> # ブレーキング ポイント タグがバージョンの増分を混乱させないようにします
    • git push origin develop
    • git push --tags

マージの 4 週間前

  • develop は新しい PR に対して閉じられ、現在の PR の修正のみがマージされる可能性があります。
  • テスターの呼び出しを投稿します

マージの 1 週間前

  • master が < 2 日前> から <マージの日> まで閉じられることを発表します

マージの 2 日前

マージの日

  • qmk_firmware git commands
    • git checkout develop
    • git pull --ff-only
    • git rebase origin/master
    • Edit readme.md
      • develop についてのメモを削除
    • ChangeLog を 1 つのファイルにまとめます。
    • git commit -m 'Merge point for <DATE> Breaking Change'
    • git push origin develop
  • GitHub Actions
    • developの PR を作成します
    • travis がクリーンに戻ったことを確認します
    • develop PR をマージします