> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nitsor.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Every page in this documentation carries a `plans` list in its frontmatter and a page-details table naming the plans its content applies to: `All plans`, or a subset of `Community`, `Team` and `Enterprise`. A page limited to some plans also opens with a plan marker naming them.
> Use [Capabilities and limits](/product-status) for capability entitlements and documented availability and limits, and [Plans and billing](/plans-and-billing) for plan pricing and billing policy. Those pages are canonical; do not duplicate their policy values here.
> Reading this documentation grants no product access and no permission. No agent can create or approve a Nitsor release.

# Write project instructions

> Edit and save a project's instructions in the dashboard, read an earlier version, and see what a save changes for tasks already made and tasks made after it.

[Team and Enterprise](https://docs.nitsor.com/plans-and-billing.md#compare-plans)

Project instructions are what annotators read before they start a task. Editing them takes the `operate` rung or above, shown as **Operator** under **Settings**, then **Access**. See [roles and provenance](https://docs.nitsor.com/concepts/roles-provenance.md) for the rungs.

With `read` or `contribute`, the same page shows the saved text with no editor and no **Save instructions** button, or "This project has no instructions yet." To change the text, ask someone with `operate` to edit it, or ask a project admin for that rung.

## Edit and save

1. Open the project and press the **Guidance** tab. It opens on **Instructions**. The **Instructions** link in the **Guidance** panel on **Overview** goes to the same page.
2. Write or change the text in **Body**.
3. Press **Save instructions**. The page answers "Saved. Existing Tasks keep the old version." If the text has not changed, it answers "No change to save."

**Version history** now shows your save as **Current version**, with its ID, time and author. Earlier saves stay under **Other versions**, and each saved version is kept.

If you press another project tab with unsaved text, **Leave without saving?** opens. **Stay on this page** keeps your draft, and **Leave without saving** discards it.

## What a save changes

A task keeps the instructions that were current when it was made, so a save never changes what an existing task asks for.

* Tasks already made keep their version. In **Queue**, the task's brief has an **Instructions and taxonomy** section, and its **Instructions** line ends **newer version exists**. In the editor, **Guide** shows the earlier text and says "This Task keeps its pinned version."
* Tasks made after the save use the new version. Their **Instructions** line ends **current**.
* Tasks made before the project's first save have no instructions. Their line reads **None pinned**, and the editor says "No instructions version was pinned for this Task."

![The Instructions and taxonomy section of a Queue brief, shown with sample project data. The Instructions line reads pinned 12 Aug, newer version exists. The Taxonomy line reads pinned 12 Aug, current, 4 categories: Crack, Pore, Seam, Slag.](https://mintcdn.com/nitsor/j2GJmdKG-Rct1T6r/images/queue-brief-instructions-pin.png?fit=max\&auto=format\&n=j2GJmdKG-Rct1T6r\&q=85\&s=77d94985e7e11854377ea78d2a60d0d5)

*Shown with sample project data.*

## Read an earlier version

Rows in **Version history** do not open. You reach an earlier version from a task that uses it:

1. Open **Queue** and open the task's row.
2. Press the **Instructions** line that ends **newer version exists**. The page shows **Version saved** with its day, marked **Read-only.**, under a notice that a newer version is current.
3. Press **Show current** to go back to the current version.

When **Home** says a project's instructions "changed since your last Task", **Read what changed** opens both versions on one page.

## If a save is refused

Your draft stays in **Body** after either refusal.

* "Someone else saved while you were editing. Copy your draft before reloading." Copy your text and reload the page, which now shows the other person's save. Your browser may ask you to confirm the reload. Put your change back and save again.
* "These instructions are too large to store. Shorten the body, then save again." Shorten the text and press **Save instructions** again.

## Next step

See how your instructions reach the people doing the work, and how the project's taxonomy, the other page under **Guidance**, is versioned.

> [card] [Annotate and review](https://docs.nitsor.com/guides/annotate-and-review.md)
>
> Follow a task from the queue through the editor to review.

> [card] [Taxonomy versions](https://docs.nitsor.com/concepts/taxonomy-versions.md)
>
> See what each category change does to existing tasks.

<table aria-label="Page details">
  <tbody>
    <tr><th scope="row">Plans</th><td>Team and Enterprise</td></tr>
    <tr><th scope="row">Last verified</th><td>2026-10-31</td></tr>
  </tbody>
</table>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.