# Version History in Action — Improve a Document Without Losing the Story

## Document Directory

This paste contains 4 documents:

- [README.md](https://marke.st/p/01M33SDAKJ6AJH5PEREH9CAZXP/README.md) ← (current)
- [launch-plan.md](https://marke.st/p/01M33SDAKJ6AJH5PEREH9CAZXP/launch-plan.md)
- [prompts/history.md](https://marke.st/p/01M33SDAKJ6AJH5PEREH9CAZXP/prompts/history.md)
- [verified-diff.md](https://marke.st/p/01M33SDAKJ6AJH5PEREH9CAZXP/verified-diff.md)

---

## README.md

# Make a change. Keep the story.

**MARKE.ST WORKFLOW / VERSION HISTORY / DIFFS / RESTORE**

An evolving document should not need a new URL for every revision. Turn on version history, edit the original paste, and use its saved versions to understand what changed.

This collection uses a tiny fictional launch plan. The document `launch-plan.md` starts with a deliberately narrow scope; its saved history demonstrates a later expansion. The example is not a real product commitment.

## The workflow

```text
Create with history enabled
          ↓
Read the current document
          ↓
Apply a small, explicit edit
          ↓
Compare the saved versions
          ↓
Keep the same paste URL
```

## Tools that preserve the context

| Need | Marke.st capability |
|---|---|
| See saved revisions | `markest_list_versions` |
| Read an old revision | `markest_get_version` or version-aware document reads |
| Compare changes | `markest_diff_versions` |
| Change a small passage | `markest_edit_document` with exact text and an optional expected hash |
| Change several files together | `markest_apply_patch`, including a dry-run option |
| Put older content back | `markest_restore_version`, after reviewing the diff |

History records later saves while enabled. Turning it off stops recording new saves but keeps versions already recorded. Turning it on cannot reconstruct changes that were never saved as versions.

## A restore is a new revision

Restoring does not rewrite the history. You can restore a whole saved paste state or a selected document; restoration does **not** change visibility. Review the difference first, especially on a public paste where the restored text becomes public immediately.

Version history is not a secret-redaction system or a substitute for backups. Avoid putting confidential material into public content in the first place.

## Try it on your own paste

Open [the history prompts](prompts/history.md). Ask the assistant to compare before changing anything, and specify whether you want one document or the entire saved state restored.

The version numbers returned by Marke.st are authoritative. Do not assume a numbered version exists just because a sample mentions one.

---
[Connect Marke.st](https://marke.st/p/01M33S86SF35M481JPJ78QCY24) · [Browse the gallery](https://marke.st/p/01M33R91CGF13BZC4KDXT2M418)