docs_write, docs_read, docs_gist and docs_gather address JSON documents, whole or a field inside each, where a field is a top-level key or a JSON Pointer such as /user/name.
A document is JSON text or bytes, a tape of them, or a dict, list or number the binding serializes, and Collection.docs takes and answers Python objects outright.
A fixed-width type given a contiguous buffer writes a column of scalars, one per key, so a NumPy column of floats or integers reaches the store without being printed as JSON and parsed back.
A gather answers the same shapes in reverse: an f16 column carries the e format, which NumPy reads as float16 without a copy, and a uuid column carries sixteen bytes per document. Table.to_pandas takes a page, converting that many rows at a time so only one page of gathered columns is ever live.
API
Types
FieldTypeHow a document or a field is spelled, or what a gather converts it into, valued as ustore_docs_field_type_t.