Skip to content

ドキュメントの更新を同期 #186

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
himaratsu wants to merge 1 commit into
base: main
Choose a base branch
from
Open

ドキュメントの更新を同期 #186

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
133 changes: 86 additions & 47 deletions docs/manual/レビュー.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,98 +5,125 @@ directory: manual

# レビュー

コンテンツを公開する際に、他のメンバーに対してレビューを申請できます。
下書き中のコンテンツを公開したり、公開中のコンテンツを公開終了したりする際に、他のメンバーに対してレビューを申請できます。
[ロール機能](https://document.microcms.io/manual/roles)と組み合わせ、複数人でコンテンツ運用する際に役立つ機能です。すべてのプランでご利用いただけます。

レビューは管理画面の左カラムにある「レビュー」>「◯件の申請」から確認できます。またレビューには「申請中」「終了済み」の2つのステータスがあります。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/e1c41c38cc1d4aa497ad2f18d08cc4d6/CleanShot%202024-04-19%20at%2011.09.38%402x.png)

人間のメンバーによるレビューに加えて、AIがコンテンツの品質確認をサポートする「AIレビュー」機能を提供しています。AIレビューの設定方法や使い方については、[AIレビュー](/manual/ai-review)のマニュアルをご覧ください。

レビュー申請をする
=========

レビュー申請をするには、下書き中のコンテンツの編集画面で「レビュー申請」をクリックします。
レビュー申請をするには、コンテンツの編集画面で［レビュー申請］ボタンをクリックします。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/ba17bfaf43b74e66a603ad731ce1dc2a/CleanShot%202024-04-19%20at%2011.10.35%402x.png)

「レビュー申請」をクリックすると、レビュー作成画面に移動します。レビュー作成画面では、
［レビュー申請］をクリックすると、レビュー作成画面に移動します。レビュー作成画面では、

* タイトル（必須）
* 説明

を入力できます。レビュアーにレビューの内容が分かるよう、タイトルと説明を記入してください。
内容を入力したら、「申請する」ボタンをクリックします。
内容を入力したら、［申請する］ボタンをクリックします。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/e92767d803a24101b841355d78f960cf/CleanShot%202024-04-19%20at%2011.12.16%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/511d12ba256e448593ae859a514b06b3/CleanShot%202025-10-27%20at%2015.35.23%402x.png)

レビュー申請のフロー
----------

レビュー申請のフローは以下の2通りがあります。

* **公開レビュー申請**：「下書き中」または「公開中かつ下書き中」から「公開中」へのレビュー
* **公開終了レビュー申請**：「公開中」から「公開終了」へのレビュー

スケジュールが設定されたコンテンツは、レビュー申請ができません。

ただし、**「公開中かつ下書き中」ステータスで、公開終了予約のみ設定されたコンテンツは、下書きの公開レビュー申請が可能です**。

公開終了したコンテンツをレビュー申請したい場合は、一度コンテンツを下書きに戻すと申請が可能になります。

レビュー申請中のコンテンツについて
-----------------

レビュー申請中のコンテンツは、ステータスが「レビュー申請中」となります。
レビュー申請中のコンテンツには、ステータスに**「公開レビュー申請中」または「終了レビュー申請中」のラベルが付与されます**。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/21c7199f776c4d449f5a339e97c4c80e/CleanShot%202024-04-19%20at%2011.50.12%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/f6a82c8deaab42bfbdd419e0daa092f9/CleanShot%202025-10-27%20at%2015.40.22%402x.png)

「レビュー申請中」のコンテンツは以下の操作ができなくなります。
レビュー申請中のコンテンツは以下の操作ができなくなります。

* 削除
###
公開レビュー申請時

* コンテンツの削除
* レビュー詳細画面以外からの公開

### 公開終了レビュー申請時

* コンテンツの削除
* コンテンツ詳細画面からの公開終了

レビューをする
=======

上記の手順でレビューを申請すると、レビュー詳細画面に移動します。

コンテンツ編集画面でレビュー申請をすると、レビュー詳細画面に移動します。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/7e5ad0453aa341a0962b50fa01f33d12/CleanShot%202024-07-04%20at%205%E2%80%AF.00.14.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/22b1a3089adf48a8ac664b3d2fcf1889/CleanShot%202025-10-27%20at%2015.59.10%402x.png)

レビュー詳細画面ではレビューに対して、以下の操作ができます。

* コンテンツの差分を確認
* コメント
* レビュアーを指定
* 公開予約日時を設定
* 承認して公開
* 公開せずに終了
* 公開予約日時／公開終了予約日時を設定
* 承認して公開／承認して公開終了
* レビューを終了
* 再申請

コンテンツの差分を確認
-----------

変更差分のタブをクリックすると、レビュー申請されたコンテンツ（最新の下書き中のコンテンツ）と公開中のコンテンツの差分を確認することができます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/57596681da0c48bf87e49933f6bf82f8/CleanShot%202024-07-04%20at%205%E2%80%AF.03.53.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/b744031a9af742be998a296e739a3820/CleanShot%202025-10-27%20at%2015.48.35%402x.png)

レビュー中にコンテンツを更新した場合、レビュータブの「コンテンツ更新：v○→v○」をクリックすることで、過去のバージョンと比較することもできます。
レビュー中にコンテンツを更新した場合、レビュータブの［コンテンツ更新：v○→v○］をクリックすることで、過去のバージョンと比較することもできます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/b4375c939de7465881fe022d1ecb679a/CleanShot%202024-07-04%20at%205%E2%80%AF.04.31.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/7038f0e2e5a0496f8e8f34dbf4e86a54/CleanShot%202025-10-27%20at%2015.49.41%402x.png)

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/6fee852d0b26418181fcb8acd233261c/CleanShot%202024-07-04%20at%205%E2%80%AF.06.50.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/bbe9a23c30b14dc98db272ae041a0bae/CleanShot%202025-10-27%20at%2016.25.54%402x.png)

* 公開レビュー申請時のみ確認ができます。

* 空の値の判定については、厳密にはデータが異なる場合にも、差分無しとして判定されることがあります。APIレスポンスに差分が無いことは、必ずしも保証されません。

コメント
----

コメント欄でコミュニケーションを取ることができます。入力したコメントは削除も可能です。
また、AIレビュアーを指定してレビューを実行した場合、AIからのフィードバックもこのコメント欄に投稿されます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/baf8c87ea272497c93d3eb06ea368135/CleanShot%202024-04-19%20at%2011.20.05%402x.png)

レビュアーを指定
--------

画面右上の「レビュアー」をクリックすることでレビュアーを指定できます。
レビューに対して、レビュアーを指定できます。
レビュアーには複数人指定できます（上限は10人）。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/5164289c50b24199814a7e2d1de6afc7/CleanShot%202024-04-19%20at%2011.21.30%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/b88af9fa14cf4e1b88b8c56d6e68d73b/CleanShot%202025-10-27%20at%2015.50.27%402x.png)

メンバー名を検索して指定できます。
また、事前に設定を行っている場合は「AIレビュアー」を指定して、レビューの自動コメントを生成することも可能です。詳しくは[AIレビュー](/manual/ai-review)をご覧ください。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/beeb738a84cf4023bdcf4de45d32f0b4/CleanShot%202024-04-19%20at%2011.22.27%402x.png)

レビュアーの候補は、[メンバーの読み取り権限](/manual/roles#heac42bdc08)の範囲にて表示されます。また、該当のレビューの読み取り権限がないメンバーは、候補から除外されます。


コメントが追加されたり、コンテンツが公開されたりした場合、レビュアーに指定されているメンバーには以下のようなメールが配信されます。
レビュアーに指名されたり、コメントが追加されたりした場合、レビュアーに指定されているメンバーには以下のようなメールが配信されます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/358c401a3d4745fdb336c357ef7c2289/CleanShot%202024-04-19%20at%2011.26.12.png)

Expand All @@ -106,50 +133,62 @@ directory: manual

* レビュアーに指名されたとき
* コメントが投稿されたとき
* 公開せずに終了したとき
* 承認して公開したとき
* レビューが終了したとき
* 承認して公開／公開終了したとき
* 再申請したとき

公開予約日時を設定
---------
公開予約日時／公開終了予約日時を設定
------------------

公開予約日時はレビュアーの下にある「公開予約日時」から設定できます。
レビューをする際、「公開予約日時」および「公開終了予約日時」を設定できます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/06a8565c710142a2907d3bbae2cd0692/CleanShot%202024-04-19%20at%2011.28.20%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/afe436dfaa184ca68d1a44865d2d7e76/CleanShot%202025-10-27%20at%2015.50.46%402x.png)

「公開予約日時」をクリックするとポップアップが表示され、
レビュー申請のフローによって、それぞれ以下の通り設定ができます。

* 公開予約日時
* 公開停止予約日時
* **公開レビュー申請**：公開予約日時／公開終了予約日時
* **公開終了レビュー申請**：公開終了予約日時

を設定できます。設定した時刻になると自動的にコンテンツを公開したり、公開停止したりできます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/4006a8d9b8d54cbc8db79027b5d096fb/CleanShot%202024-04-19%20at%2011.30.06%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/e6fed1f320d2424e887eb7d16e1208d7/CleanShot%202025-10-28%20at%2012.04.53.png)

「承認して公開予約」ボタンをクリックしない限り、公開予約日時を設定しても予約公開されることはありません。
［承認して公開予約］または［承認して公開終了］を実行しない限り、予約日時を設定してもコンテンツが更新されることはありません。

承認して公開
------
承認して公開／公開終了
-----------

レビューが完了し、公開する準備が整ったら、「承認して公開」をクリックしコンテンツを公開します。
「承認して公開」をクリックすると、レビューのステータスは「終了済み」となり、コンテンツは公開状態となります。
レビューが完了したら、［承認して公開］または［承認して公開終了］をクリックしコンテンツを更新します。
いずれかのボタンをクリックすると、レビューのステータスは「終了済み」となります。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/09f81ca18f994dbc9a31978f128394be/CleanShot%202024-04-19%20at%2011.31.37%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/14f6d3b8289d4ccb9dfc7978d9e23477/CleanShot%202025-10-27%20at%2015.51.31%402x.png)

公開予約日時が設定されている場合は「承認して公開予約」ボタンとなり、設定された時刻に公開されます。
公開予約日時または公開終了予約日時が設定されている場合は［承認して公開予約］または［承認して公開終了］ボタンとなり、設定された時刻に更新されます。

公開せずに終了
レビューを終了
-------

レビューの内容が否認された場合、コンテンツを公開せずに終了することもできます。
「公開せずに終了」をクリックすると、レビューのステータスは「終了済み」に、コンテンツは「下書き中」状態のままとなります。
レビューの内容が否認された場合、コンテンツを更新せずに終了することもできます。
［レビューを終了］をクリックすると、レビューのステータスは「終了済み」に、コンテンツは元の状態のままとなります。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/a85a1cad12fa4682a1407b515e44b0a6/CleanShot%202024-04-19%20at%2011.36.44%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/83da89726ec247d2931b4e9af41370ab/CleanShot%202025-10-28%20at%2012.13.09%402x.png)

再申請
---

一度公開せずに終了され、「終了済み」となったレビューは再申請できます。
「再申請」をクリックすると、レビューのステータスは「申請中」に戻ります。
レビューが否認された結果、「終了済み」となったレビューは再申請できます。
［再申請する］をクリックすると、レビューのステータスは「申請中」に戻ります。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/eaebda6947f74c31bcedcc1f8b84ff13/CleanShot%202024-04-19%20at%2011.42.26%402x.png)
![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/c28c8cb6378840deb05a31a0d989aaef/CleanShot%202025-10-28%20at%2012.13.56%402x.png)

レビュー設定
======

管理者ロールを持つメンバーは、レビュー管理画面の右上にある［レビュー設定］ボタンから、レビューに関する各種設定を行うことができます。

![](https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/119bf9defd7f4c46805babb861a115d8/CleanShot%202026-04-02%20at%2018.14.32%402x.png)

AIレビュアーの管理
----------

現在のところ、レビュー設定画面では「AIレビュアー」の管理が可能です。
AIレビュアーの設定手順や詳細な使い方については、[AIレビュー](/manual/ai-review)のマニュアルをご覧ください。