# Release and Revise

Inspectors can only run a **Released** check sheet. Once it is released, you can't edit it directly. You change it through a
**revision**. This protects your data, because every completed check records which version was used.

:::warning
Releasing a check sheet, and releasing a revision, changes what everyone sees. Check your changes first. On a production
system, they are real.
:::

:::info
Releasing and revising needs the **Configure Quality** security function.
:::

## Know the Version States

Each check sheet has a status in the check sheet table.

![Check sheet table with versions](https://docs.kanoa.ai/img/quality/checkSheetVersioning.png)

| State | What it means |
| --- | --- |
| **Draft** | A new check sheet that hasn't been released. It's version 1. |
| **Released** | The version inspectors use. There is one released version at a time. |
| **In Revision** | A copy of the released version that you're editing. It's disabled, so inspectors don't see it. |
| **Archived** | A version that a newer release replaced. It's kept with its events. |

## Release a Check Sheet

1. Open **Configuration → Quality → Check Sheets**.
2. Check the new sheet's status is **Draft**.
3. Change its status to **Released**.

Open the sheet again. You can no longer change its items.

## Revise a Released Check Sheet

You need a revision for any change, including triggers, not only check items.

1. In **Check Sheets**, change the status from **Released** to **In Revision**.
2. Open the revision and make your changes.
3. Save, close the editor, and change the status back to **Released**.

While the sheet is **In Revision**, everyone, including Gateway Admins, can only start the released version. Inspectors keep
working as normal until you release.

## What a Revision Does

1. When you set **In Revision**, Kanoa copies the released sheet to a new check sheet named "*name* - In Revision" with the
   next version number. You edit the copy.
2. When you release it, the old version is **archived** and renamed with its version number. The revision becomes
   **Released**, is enabled and gets the original name back.
3. Check sheets that used any version as their re-test sheet now use the new release.

Checks that inspectors add after you release use the new version. Each version is its own check sheet. A check you already took
keeps the version it was taken on, so you can always tell which version an inspector filled in. Reports and SPC include the
checks of every version.

## Go Back to an Earlier Version

Click the arrow at the far left of a check sheet's row to show its earlier versions. You can view each one and revert to it.
Reverting sets that version back to **In Revision** as the newest version. Release it to put it back in use.

::embed-section{src="../../kanoa-quality/checkSheets.md#check-sheet-version-control" collapsed="true" summary="Reference Materials: Check Sheet Version Control - States, revisions and reverting."}

Views and scripts that refer to a check sheet by a stored id need care after a release. That is Developer Training.

## Check Your Understanding

1. What status does a new check sheet have?
2. Can inspectors use a check sheet while you revise it?
3. What happens to the old version when you release a revision?

<details>
<summary>Answers</summary>

1. **Draft**.
2. Yes. They keep using the released version until you release the revision.
3. It is archived, renamed with its version number and kept with its events.

</details>
