docs: resolve mkdocs build warnings and tighten public API surface

Bring the strict mkdocs build to zero actionable warnings.

Cross-reference fixes:
- Replace ~20 unqualified `[X][X]` refs with fully-qualified targets
  (sort/sort_by, cube/rollup/grouping_sets, array_* aliases, register_*,
  Volatility, Serde, Producer, max_rows, metrics, etc.).
- Fix typos: `Dataframe` -> `DataFrame`, `datafusion.Expr.to_bytes` ->
  `datafusion.expr.Expr.to_bytes`.
- Drop links to non-Python symbols: `SessionState`, `CreateExternalTable`,
  `multiprocessing.Pool`, `cloudpickle`; point the `ObjectStore`
  reference at the module page; link `LogicalExtensionCodec` to
  `with_logical_extension_codec`.
- Update relative link in `dataframe_formatter.md` for the subdirectory
  move.

Public surface and reference page coverage:
- Add `__all__` to `context`, `dataframe`, `dataframe_formatter`, `io`,
  `record_batch`, `user_defined`, `input/base`, `input/location` so the
  public surface is explicit.
- Document the newly-declared public symbols on the corresponding
  reference pages (Compression, Volatility, *Exportable Protocols,
  ArrowStreamExportable, etc.).
- Update `object_store.md` to render the PyO3 class aliases via explicit
  per-class directives (whole-module discovery skips re-assigned PyO3
  bindings).
- Allow `__next__`/`__anext__` through the formatter filter on
  `RecordBatchStream` so the iterator protocol is documented.

Docstring fixes:
- Convert overload-impl Args blocks (ScalarUDF.udf, AggregateUDF.udaf,
  WindowUDF.udwf) to free-form prose: their actual signatures are
  `*args, **kwargs`, which griffe was flagging.
- Fix Args continuation indent in the formatter, the `idx::` typo, and a
  `with_extension` Args entry whose continuation lost its indent.
- Re-wrap doctring lines that pushed past the 88-column limit after the
  cross-ref qualifications.

mkdocstrings config: add `docstring_options: warn_unknown_params: false`
so future overload-impl patterns don't trip the build.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: timsaucer

docs/source/reference/datafusion/context.md

@@ -11,3 +11,11 @@
 ::: datafusion.context.SQLOptions
 
 ::: datafusion.context.RuntimeEnvBuilder
+
+::: datafusion.context.ArrowStreamExportable
+
+::: datafusion.context.ArrowArrayExportable
+
+::: datafusion.context.TableProviderExportable
+
+::: datafusion.context.PhysicalOptimizerRuleExportable

docs/source/reference/datafusion/dataframe.md

@@ -16,6 +16,8 @@
 
 ::: datafusion.dataframe.ExplainFormat
 
+::: datafusion.dataframe.Compression
+
 ## DataFrame Formatter
 
 See [DataFrame Formatter](dataframe_formatter.md) for the full formatter API

docs/source/reference/datafusion/dataframe_formatter.md

@@ -2,7 +2,7 @@
 
 The `datafusion.dataframe_formatter` module controls how DataFrames render
 in notebooks and HTML contexts. See the user-guide
-[Rendering](../user-guide/dataframe/rendering.md) page for worked examples.
+[Rendering](../../user-guide/dataframe/rendering.md) page for worked examples.
 
 ::: datafusion.dataframe_formatter.configure_formatter
 

docs/source/reference/datafusion/object_store.md

@@ -1,3 +1,15 @@
 # Object Store
 
 ::: datafusion.object_store
+    options:
+      members: false
+
+::: datafusion.object_store.AmazonS3
+
+::: datafusion.object_store.GoogleCloud
+
+::: datafusion.object_store.Http
+
+::: datafusion.object_store.LocalFileSystem
+
+::: datafusion.object_store.MicrosoftAzure

docs/source/reference/datafusion/record_batch.md

@@ -3,3 +3,8 @@
 ::: datafusion.record_batch.RecordBatch
 
 ::: datafusion.record_batch.RecordBatchStream
+    options:
+      filters:
+        - "!^_"
+        - "^__next__$"
+        - "^__anext__$"

docs/source/reference/datafusion/user_defined.md

@@ -1,5 +1,7 @@
 # User-Defined Functions
 
+::: datafusion.user_defined.Volatility
+
 ::: datafusion.user_defined.ScalarUDF
 
 ::: datafusion.user_defined.AggregateUDF
@@ -19,3 +21,13 @@
 ::: datafusion.user_defined.udwf
 
 ::: datafusion.user_defined.udtf
+
+::: datafusion.user_defined.ScalarUDFExportable
+
+::: datafusion.user_defined.AggregateUDFExportable
+
+::: datafusion.user_defined.WindowUDFExportable
+
+::: datafusion.user_defined.LogicalExtensionCodecExportable
+
+::: datafusion.user_defined.PhysicalExtensionCodecExportable

docs/source/user-guide/common-operations/aggregations.md

@@ -453,8 +453,8 @@ The available aggregate functions are:
 
 You can ship custom aggregations to the engine by subclassing
 [`Accumulator`][datafusion.user_defined.Accumulator] and registering it via
-[`udaf`][datafusion.user_defined.udaf]. See [`user_defined`][datafusion.user_defined] for
-the accumulator interface and worked examples.
+[`udaf`][datafusion.user_defined.udaf]. See [`user_defined`](../../reference/datafusion/user_defined.md)
+for the accumulator interface and worked examples.
 
 <div class="admonition note">
 <p class="admonition-title">Note</p>

docs/source/user-guide/common-operations/windows.md

@@ -208,7 +208,7 @@ The possible window functions are:
 
 You can ship custom window functions to the engine by subclassing
 [`WindowEvaluator`][datafusion.user_defined.WindowEvaluator] and registering it
-via [`udwf`][datafusion.user_defined.udwf]. See [`user_defined`](../../reference/user_defined.md)
+via [`udwf`][datafusion.user_defined.udwf]. See [`user_defined`](../../reference/datafusion/user_defined.md)
 for the evaluator interface and worked examples.
 
 <div class="admonition note">

mkdocs.yml

@@ -68,6 +68,10 @@ plugins:
             - https://docs.pola.rs/api/python/stable/objects.inv
           options:
             docstring_style: google
+            docstring_options:
+              warn_unknown_params: false
+              returns_named_value: false
+              returns_multiple_items: false
             show_source: false
             members_order: source
             inherited_members: true

python/datafusion/catalog.py

@@ -239,7 +239,7 @@ class TableProviderFactory(ABC):
 
     @abstractmethod
     def create(self, cmd: CreateExternalTable) -> Table:
-        """Create a table using the [`CreateExternalTable`][CreateExternalTable]."""
+        """Create a table using the `CreateExternalTable`."""
         ...