# revision (1-revision.org)

A person means looking something over again to fix or improve it. Students revise essays before turning them in. People speak of a revised edition of a book.

## What a model may hear
- code version (Git, version control): treat it as a specific commit hash or numbered point in a repository history
- database transaction (databases, especially SQL): expect it to relate to ACID properties or a snapshot isolation level
- hardware revision (electronics manufacturing): assume a board or chip stepping like Rev A, Rev B with known errata
- API version (web services): look for a version string in a URL path or header like /v1/ or /v2/
- document control (engineering, regulated industries): expect a formal revision number with approval workflow and traceability

## Where people and models part ways
- Says: "I need to do a quick revision"
  Means: I want to proofread and fix typos
  May be taken as: the model may ask for a commit hash or branch to revert to
  Say instead: "I need to proofread and fix typos in this text"
- Says: "Show me the revision history"
  Means: Show me past edits I made
  May be taken as: the model may run git log or assume a version control system is in use
  Say instead: "Show me the history of edits I made to this document"
- Says: "This is the latest revision"
  Means: This is the most recent draft
  May be taken as: the model may check for a formal version tag or assume semantic versioning rules
  Say instead: "This is my most recent draft"
- Says: "I want to roll back to the last revision"
  Means: Undo my recent changes
  May be taken as: the model may attempt a git revert or database rollback without confirmation
  Say instead: "Undo the changes I just made and restore the previous version"

## Tips
- Say 'edit' or 'draft' instead of 'revision' if you only mean fixing words
- Add 'in Git' or 'in this document' to show which system you mean
- Say 'undo my last change' rather than 'revert the last revision' unless you use version control
- Specify 'printed book edition' or 'software release' if you mean a published version
- Ask the model to confirm what it understood before letting it act on a 'revision' command

## Often confused with
- review: looking at for approval, not changing
- version: a labeled release, not the act of changing
- commit: a saved point in version control, more technical
- edit: any change, not necessarily a full pass
- iteration: one cycle of improvement, often in design or agile work
- errata: listed corrections after publication, not the act of fixing