wip

Author: mxcl

SPEC.md

@@ -451,6 +451,9 @@ SMBH is a website where humans curate shelves of books and media.
 - DELETE /shelves/:shelfId/books/:bookId
 ```
 
+Note that the `DELETE` is non-destructive as it *archives* the book from the
+shelf rather than deleting it from the account.
+
 ---
 
 # Example Flows