Skip to content

Commit

Permalink
Merge pull request #6 from VirtualLiveLab/docs/how-to-change
Browse files Browse the repository at this point in the history
docs: 改定手順書を作成
  • Loading branch information
sushichan044 authored Apr 7, 2024
2 parents 4d74e5a + c12ea81 commit 00ae552
Show file tree
Hide file tree
Showing 3 changed files with 73 additions and 0 deletions.
73 changes: 73 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,3 +14,76 @@
- かっこは半角`()`を用いる
- 前には必ず半角スペースを挿入
- 後ろに文があれば後ろにも半角スペースを挿入

## 改定時の手順

### 1. ブランチの作成

改定・施行日に合わせたブランチを`yyyy-mm-dd`という名前で`main`から作成する。

例: 改定・施行日が2024年4月2日の場合→`2024-04-02`

### 2. 改定内容の入力

1.で作成したブランチに移動し、改定内容を入力する。
総会での決議ごとにコミットを分けることが望ましい。

### 3. 誤字脱字および表記規則チェック

誤字脱字と表記規則に関するチェックを行う。

> [!WARNING]
> 特に全角の`()`や全角スペース、全角英数字の混入に注意すること。
気が向いたらGitHub Actionsでのチェックを導入する。

### 4. Pull Requestを作成

`main`ブランチへ向けてPull Requestを作成する。

マージ規則については、2024年4月時点では検討中である。

### 5. Releaseを作成

改定内容が`main`にマージされたらTagを切ってReleaseを作成する。

まずReleasesページへ移動し、上部の`Draft a New Release`をクリック。

次に`Choose a tag`をクリックして、新しいタグ名を入力することで改定・施行日に合わせたタグを作成する。

ただし、タグ命名規則には`yyyy.mm.dd`を採用する。

例: 改定・施行日が2024年4月2日の場合→`2024.04.02`

> [!CAUTION]
> ブランチ命名規則と異なることに注意。
---

その後、

- `Target: main`
- `Previous tag: auto`

であることを確認したら`Generate release notes`をクリックしてリリースノートを生成する。

この時点で下の写真のように

- Release Nameが自動的に`yyyy.mm.dd`に設定される
- Release NoteにChange Logが自動入力される

はずである。なお、Pull Requestをマージしたあとであればその記述も入力される。

> [!CAUTION]
> もしリリースノートを生成した際に上のいずれかを満たしていなければ何らかの間違いがある。
> 必ず引き返すこと。
![Releasesが選択され、指定したタグからリリース名とリリースノートを正しく生成できている例](docs/release-note.png)

---

リリース名とリリースノートが正しいことを確認したら、下部の`Set as the latest release`にチェックが入っていることを確認して`Publish release`をクリックする。

あとはリポジトリトップに戻り、Releasesの部分に正しい改定日と`Latest`が表示されていれば改定完了。

![alt text](docs/change-success.png)
Binary file added docs/change-success.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/release-note.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 00ae552

Please sign in to comment.