Residual migration from reconciliation branch

docs/data_models/index.md

@@ -4,6 +4,6 @@ This section contains the data models for the MDIO format.
 
 ```{toctree}
 :maxdepth: 2
-v0
-v1
+version_0
+version_1
 ```

src/mdio/segy/creation.py

@@ -43,15 +43,15 @@ def make_segy_factory(
     )
 
 
-def mdio_spec_to_segy(
-    mdio_path_or_buffer,
-    output_segy_path,
-    access_pattern,
-    output_endian,
-    storage_options,
-    new_chunks,
-    backend,
-):
+def mdio_spec_to_segy(  # noqa: PLR0913 DOC107
+    mdio_path_or_buffer: str,
+    output_segy_path: str,
+    access_pattern: str,
+    output_endian: Endianness,
+    storage_options: dict[str],
+    new_chunks: tuple[int, ...],
+    backend: str,
+) -> tuple[MDIOReader, SegyFactory]:
     """Create SEG-Y file without any traces given MDIO specification.
 
     This function opens an MDIO file, gets some relevant information for SEG-Y files,

src/mdio/segy/geometry.py

@@ -209,7 +209,7 @@ def create_counter(
     total_depth: int,
     unique_headers: dict[str, NDArray],
     header_names: list[str],
-):
+) -> int | dict:
     """Helper function to create dictionary tree for counting trace key for auto index."""
     if depth == total_depth:
         return 0
@@ -230,8 +230,8 @@ def create_trace_index(
     counter: dict,
     index_headers: HeaderArray,
     header_names: list,
-    dtype=np.int16,
-):
+    dtype: np.dtype = np.int16,
+) -> None | HeaderArray:
     """Update dictionary counter tree for counting trace key for auto index."""
     if depth == 0:
         # If there's no hierarchical depth, no tracing needed.
@@ -262,7 +262,9 @@ def create_trace_index(
     return index_headers
 
 
-def analyze_non_indexed_headers(index_headers: HeaderArray, dtype=np.int16) -> NDArray:
+def analyze_non_indexed_headers(
+    index_headers: HeaderArray, dtype: np.dtype = np.int16
+) -> NDArray:
     """Check input headers for SEG-Y input to help determine geometry.
 
     This function reads in trace_qc_count headers and finds the unique cable values.