andygrove opened a new pull request, #4055:
URL: https://github.com/apache/datafusion-comet/pull/4055
## Which issue does this PR close?
N/A, documentation restructuring.
## Rationale for this change
The compatibility guide had grown into a single long page mixing scans,
expressions, operators, regex, floating-point semantics, and the cast support
matrix. Splitting it into topic-focused pages under `compatibility/` makes each
area easier to find and to extend as new notes accumulate.
## What changes are included in this PR?
- New structure under `docs/source/user-guide/latest/compatibility/`:
- `index.md` (intro + toctree)
- `scans.md`, `floating-point.md`, `regex.md`, `operators.md`
- `expressions/` with `index.md`, `aggregate.md`, `array.md`,
`datetime.md`, `struct.md`, `cast.md`
- `GenerateDocs.scala` repointed so cast tables populate the new
`compatibility/expressions/cast.md` at build time.
- Top-level user-guide toctree (`index.rst`) updated to point at
`compatibility/index`.
- Five cross-references in `datatypes.md`, `expressions.md`, `operators.md`,
`gluten_comparison.md`, `adding_a_new_operator.md` repointed to the most
relevant new page.
- Old monolithic `compatibility.md` deleted.
Content moves are verbatim; no compatibility notes were added or removed.
## How are these changes tested?
Ran `docs/build.sh`. Maven + `GenerateDocs` succeeded and populated all
three cast tables (Legacy/Try/ANSI) in
`docs/temp/.../compatibility/expressions/cast.md`. Verified no stale
`compatibility.md` references remain in `docs/source/` or `GenerateDocs.scala`.
Sphinx HTML rendering not exercised locally (no `sphinx-build` installed); CI
will cover it.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
