Quoting

Added
Purpose
Lift a passage out of a document so it can be kept, referred to and found on its own.
Operational principle
If a member selects a passage and saves it, it exists as a quote that names its source and the range it came from; the member finds it later without reopening the document.
State
  • source: Quote -> one Document
  • range: Quote -> one Range
  • text: Quote -> one Text
  • createdBy: Quote -> one User
Actions
  • createQuote A member saves a passage of a document as a quote that keeps its text, its source and its range.
Misfits
  • A quote keeps its text when the source changes, so it can say something the document no longer says.
  • A quote's range is in the source's terms, and a revision that moves the passage leaves the range pointing at the wrong place.
Also called
excerpt, highlight, clipping
Depends on
Document keeping
Appears in
Kindle highlights, Readwise, Notion block references