revision
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
“I need to do a quick revision”
Meant: 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”
“Show me the revision history”
Meant: 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”
“This is the latest revision”
Meant: 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”
“I want to roll back to the last revision”
Meant: 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