# rest (10-rest.com)

People say rest when they want to stop working, sleep, or take a break. It means easing the body or mind. It can also mean what remains after something is taken away.

## What a model may hear
- Representational State Transfer (software architecture and web APIs): assume the user wants to build or interact with a web service using HTTP methods like GET and POST in a stateless, resource-oriented way
- sleep or halt state (operating systems and hardware): treat the request as a power-management command, putting a device into standby or sleep mode
- remainder or leftover (mathematics and programming): compute or return the remainder after division, or the remaining elements of a set or list
- musical silence (music notation): interpret the input as a directive to insert a pause of a specific duration in a score

## Where people and models part ways
- Says: "I need some rest"
  Means: I want to stop and recover
  May be taken as: the model generates code for a REST API or puts a system to sleep
  Say instead: "I need to take a break and stop working for a while"
- Says: "what is left?"
  Means: what remains?
  May be taken as: the model explains REST architecture or returns a mathematical remainder
  Say instead: "what remains after we remove these items?"
- Says: "give it a rest"
  Means: stop talking about it
  May be taken as: the model creates a REST endpoint or pauses a process
  Say instead: "stop discussing this topic"
- Says: "the rest of the story"
  Means: the remaining part
  May be taken as: the model assumes a technical context and offers API documentation patterns
  Say instead: "the remaining part of the story"

## Tips
- If you mean sleep or relaxation, say sleep, break, or time off instead of rest
- If you mean what remains, say remaining, leftover, or the rest of the items
- If you want a REST API, spell it out as REST API or web service to be clear
- Avoid rest as a verb when you mean pause; say pause, stop, or wait instead
- If you mean musical silence, say musical rest or pause in the music

## Often confused with
- sleep: only biological rest, no technical meaning
- pause: a temporary stop, not an architecture style
- remainder: only the mathematical leftover, no relaxation sense
- API: the technical interface, not the concept of relaxation
- relax: only the emotional or physical easing, no computing sense
- residue: only what remains chemically or mathematically