blobs-api.md

+This page documents current research about blobs api in soledad. 
+
+* Some of the discussion started [here](#8690).
+* What we want for now:
+  * ability to access blob fd
+  * ability to defer to when blob is available
+  * possibility of seamless fallback
+  * predictability from the application perspective
+
+Current proposal:
+
+* A "blob document" is a normal document with two special fields in its content: `doc.content = {'is_blob': True, 'blob_id': '<id>'}`.
+* `create_blob(metadata, fd, doc_id=None)`: returns a blob document.
+* `get_blob(blob_id)`: returns a file descriptor.
\ No newline at end of file