Update docs: use <djblob> for serialized data, longblob for raw bytes

Author: claude

docs/src/compute/key-source.md

@@ -45,7 +45,7 @@ definition = """
 -> Recording
 ---
 sample_rate : float
-eeg_data : longblob
+eeg_data : <djblob>
 """
 key_source = Recording & 'recording_type = "EEG"'
 ```

docs/src/compute/make.md

@@ -152,7 +152,7 @@ class ImageAnalysis(dj.Computed):
     # Complex image analysis results
     -> Image
     ---
-    analysis_result : longblob
+    analysis_result : <djblob>
     processing_time : float
     """
 
@@ -188,7 +188,7 @@ class ImageAnalysis(dj.Computed):
     # Complex image analysis results
     -> Image
     ---
-    analysis_result : longblob
+    analysis_result : <djblob>
     processing_time : float
     """
 

docs/src/compute/populate.md

@@ -40,7 +40,7 @@ class FilteredImage(dj.Computed):
      # Filtered image
      -> Image
      ---
-     filtered_image : longblob
+     filtered_image : <djblob>
      """
 
      def make(self, key):
@@ -196,7 +196,7 @@ class ImageAnalysis(dj.Computed):
     # Complex image analysis results
     -> Image
     ---
-    analysis_result : longblob
+    analysis_result : <djblob>
     processing_time : float
     """
 
@@ -230,7 +230,7 @@ class ImageAnalysis(dj.Computed):
     # Complex image analysis results
     -> Image
     ---
-    analysis_result : longblob
+    analysis_result : <djblob>
     processing_time : float
     """
 

docs/src/design/integrity.md

@@ -142,7 +142,7 @@ definition = """
 -> EEGRecording
 channel_idx : int
 ---
-channel_data : longblob
+channel_data : <djblob>
 """
 ```
 ![doc_1-many](../images/doc_1-many.png){: style="align:center"}

docs/src/design/tables/attributes.md

@@ -48,9 +48,10 @@ fractional digits.
    Because of its well-defined precision, `decimal` values can be used in equality
    comparison and be included in primary keys.
 
--  `longblob`: arbitrary numeric array (e.g. matrix, image, structure), up to 4
+-  `longblob`: raw binary data, up to 4
 [GiB](http://en.wikipedia.org/wiki/Gibibyte) in size.
-   Numeric arrays are compatible between MATLAB and Python (NumPy).
+   Stores and returns raw bytes without serialization.
+   For serialized Python objects (arrays, dicts, etc.), use `<djblob>` instead.
    The `longblob` and other `blob` datatypes can be configured to store data
    [externally](../../sysadmin/external-store.md) by using the `blob@store` syntax.
 
@@ -71,6 +72,10 @@ info).
 These types abstract certain kinds of non-database data to facilitate use
 together with DataJoint.
 
+- `<djblob>`: DataJoint's native serialization format for Python objects. Supports
+NumPy arrays, dicts, lists, datetime objects, and nested structures. Compatible with
+MATLAB. See [custom types](customtype.md) for details.
+
 - `attach`: a [file attachment](attach.md) similar to email attachments facillitating
 sending/receiving an opaque data file to/from a DataJoint pipeline.
 

docs/src/design/tables/customtype.md

@@ -454,7 +454,7 @@ schema = dj.schema("mydb")
 
 1. **Choose descriptive type names**: Use lowercase with underscores (e.g., `spike_train`, `graph_embedding`)
 
-2. **Select appropriate storage types**: Use `longblob` for complex objects, `json` for simple structures, external storage for large data
+2. **Select appropriate storage types**: Use `<djblob>` for complex objects, `json` for simple structures, external storage for large data
 
 3. **Add validation**: Use `validate()` to catch data errors early
 

docs/src/design/tables/master-part.md

@@ -26,8 +26,8 @@ class Segmentation(dj.Computed):
           -> Segmentation
           roi  : smallint   # roi number
           ---
-          roi_pixels  : longblob   #  indices of pixels
-          roi_weights : longblob   #  weights of pixels
+          roi_pixels  : <djblob>   #  indices of pixels
+          roi_weights : <djblob>   #  weights of pixels
           """
 
      def make(self, key):
@@ -101,7 +101,7 @@ definition = """
 -> ElectrodeResponse
 channel: int
 ---
-response: longblob  # response of a channel
+response: <djblob>  # response of a channel
 """
 ```