andygrove opened a new pull request, #4568: URL: https://github.com/apache/datafusion-comet/pull/4568
## Which issue does this PR close? No dedicated issue. This is a documentation reorganization follow-up to the recent work that made the user guide the source of truth for expression support status. ## Rationale for this change The user guide `expressions.md` is now a comprehensive per-category status table and is the source of truth for which expressions Comet supports. The contributor guide `spark_expressions_support.md` duplicated that as a `[x]`/`[ ]` checklist, with the only unique content being per-version audit notes. Keeping two lists of support status invites drift. This PR makes the split explicit: the user guide owns support status, and the contributor guide owns the audit record. ## What changes are included in this PR? - Add a new "Expression Audits" section under the contributor guide at `docs/source/contributor-guide/expression-audits/`, with an index page and one page per Spark function-registry category. Each audited expression gets a heading and its per-version audit notes as bullets. Only expressions that have actually been audited appear; there is no content for unsupported or unaudited expressions. - Delete `spark_expressions_support.md`. Its checklist role is replaced by the user guide, and its audit notes are migrated verbatim into the new pages (470 audit bullets across 182 expressions in 17 categories, reconciled 1:1 against the old file). - Point the "Finding an Expression to Add" guidance in `adding_a_new_expression.md` at the user guide for support status, and at the new audit pages for deep-dive notes. - Repoint the `expressions.md` "See also" link and the contributor guide toctree to the new section. - Update the `audit-comet-expression`, `implement-comet-expression`, and `wire-datafusion-function` skills to reference the new layout. ## How are these changes tested? Documentation-only change. The migration was performed with a script that reconciles the migrated audit bullet count and per-category audited-expression count 1:1 against the old document, and the toctree was verified to reference every new page (no orphaned pages). The docs site is built and published by CI. -- 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]
