aboutsummaryrefslogtreecommitdiff
path: root/docs/ja/breaking_changes.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ja/breaking_changes.md')
-rw-r--r--docs/ja/breaking_changes.md120
1 files changed, 120 insertions, 0 deletions
diff --git a/docs/ja/breaking_changes.md b/docs/ja/breaking_changes.md
new file mode 100644
index 000000000..936d0a472
--- /dev/null
+++ b/docs/ja/breaking_changes.md
@@ -0,0 +1,120 @@
1# Breaking changes/互換性を破る変更
2
3<!---
4 grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
5 original document: 0.9.0:docs/breaking_changes.md
6 git diff 0.9.0 HEAD -- docs/breaking_changes.md | cat
7-->
8
9このドキュメントは QMK の互換性を破る変更(Breaking change) のプロセスについて説明します。
10互換性を破る変更とは、互換性がなかったり潜在的な危険が生じるように QMK の動作を変える変更を指します。
11ユーザが QMK ツリーを更新しても自分のキーマップが壊れない事を確信できるように、これらの変更を制限します。(訳注:以後、原文のまま Breaking change を用語として使用します。)
12
13Breaking change ピリオドとは、危険な変更、または予想外の変更を QMK へ行なう PR をマージする時のことです。
14付随するテスト期間があるため、問題が起きることはまれか、有りえないと確信しています。
15
16## 過去の Breaking change には何が含まれますか?
17
18* [2020年5月30日](ja/ChangeLog/20200530.md)
19* [2020年2月29日](ja/ChangeLog/20200229.md)
20* [2019年8月30日](ja/ChangeLog/20190830.md)
21
22## 次の Breaking change はいつですか?
23
24次の Breaking change は2020年8月29日に予定されています。
25
26### 重要な日付
27
28* [x] 2020年 5月30日 - `develop` が作成されました。毎週リベースされます。
29* [ ] 2020年 8月 1日 - `develop` は新しいPRを取り込みません。
30* [ ] 2020年 8月 1日 - テスターの募集。
31* [ ] 2020年 8月27日 - `master`がロックされ、PR はマージされません。
32* [ ] 2020年 8月29日 - `develop` を `master` にマージします。
33* [ ] 2020年 8月29日 - `master` のロックが解除されます。PR を再びマージすることができます。
34
35## どのような変更が含まれますか?
36
37最新の Breaking change 候補を見るには、[`breaking_change` ラベル](https://github.com/qmk/qmk_firmware/pulls?q=is%3Aopen+label%3Abreaking_change+is%3Apr)を参照してください。
38現在から `develop` が閉じられるまでの間に新しい変更が追加される可能性があり、そのラベルが適用された PR はマージされることは保証されていません。
39
40このラウンドに、あなたの Breaking change を含めたい場合は、`breaking_change` ラベルを持つ PR を作成し、`develop` が閉じる前に承認してもらう必要があります。
41`develop` が閉じた後は、新しい Breaking change は受け付けられません。
42
43受け入れの基準:
44
45* PR が完了し、マージの準備ができている
46* PR が ChangeLog を持つ
47
48# チェックリスト
49
50ここでは、Breaking change プロセスを実行する時に使用する様々なプロセスについて説明します。
51
52## `master` から `develop` をリベースします
53
54これは `develop` が開いている間、毎週金曜日に実行されます。
55
56プロセス:
57
58```
59cd qmk_firmware
60git checkout master
61git pull --ff-only
62git checkout develop
63git rebase master
64git push --force
65```
66
67## `develop` ブランチの作成
68
69以前の `develop` ブランチがマージされた直後に、これが発生します。
70
71* `qmk_firmware` git commands
72 * [ ] `git checkout master`
73 * [ ] `git pull --ff-only`
74 * [ ] `git checkout -b develop`
75 * [ ] Edit `readme.md`
76 * [ ] これがテストブランチであることを上部に大きな通知で追加します。
77 * [ ] このドキュメントへのリンクを含めます
78 * [ ] `git commit -m 'Branch point for <DATE> Breaking Change'`
79 * [ ] `git tag breakpoint_<YYYY>_<MM>_<DD>`
80 * [ ] `git tag <next_version>` # ブレーキング ポイント タグがバージョンの増分を混乱させないようにします
81 * [ ] `git push origin develop`
82 * [ ] `git push --tags`
83
84## マージの 4 週間前
85
86* `develop` は新しい PR に対して閉じられ、現在の PR の修正のみがマージされる可能性があります。
87* テスターの呼び出しを投稿します
88 * [ ] Discord
89 * [ ] GitHub PR
90 * [ ] https://reddit.com/r/olkb
91
92## マージの 1 週間前
93
94* master が < 2 日前> から <マージの日> まで閉じられることを発表します
95 * [ ] Discord
96 * [ ] GitHub PR
97 * [ ] https://reddit.com/r/olkb
98
99## マージの 2 日前
100
101* master が 2 日間閉じられることを発表します
102 * [ ] Discord
103 * [ ] GitHub PR
104 * [ ] https://reddit.com/r/olkb
105
106## マージの日
107
108* `qmk_firmware` git commands
109 * [ ] `git checkout develop`
110 * [ ] `git pull --ff-only`
111 * [ ] `git rebase origin/master`
112 * [ ] Edit `readme.md`
113 * [ ] `develop` についてのメモを削除
114 * [ ] ChangeLog を 1 つのファイルにまとめます。
115 * [ ] `git commit -m 'Merge point for <DATE> Breaking Change'`
116 * [ ] `git push origin develop`
117* GitHub Actions
118 * [ ] `develop`の PR を作成します
119 * [ ] travis がクリーンに戻ったことを確認します
120 * [ ] `develop` PR をマージします