Skip to content

Story 17.6 — Known Limitations & Roadmap MD mirror (honest BI-tool gap framing) — elasticsql#141

Draft
fupelaqu wants to merge 2 commits into
release-r1from
feature/17.6
Draft

Story 17.6 — Known Limitations & Roadmap MD mirror (honest BI-tool gap framing) — elasticsql#141
fupelaqu wants to merge 2 commits into
release-r1from
feature/17.6

Conversation

@fupelaqu

Copy link
Copy Markdown
Contributor

Epic 17 (R1 Documentation & Marketing), Story 17.6 — Layer 0. Closes #139.

MD mirror (dual-docs-sync) of the canonical web Known Limitations & Roadmap page (softclient4es-web PR #17 / issue #15). Token-for-token parity with the web MDX.

Changes

  • NEW documentation/sql/known_limitations.md ([Back to index](README.md) + # Known Limitations & Roadmap H1)
  • UPDATE documentation/sql/README.md — index link after DQL Support
  • Inbound "Known limitations" one-liners on documentation/sql/dql_statements.md and documentation/client/arrow_flight_sql.md

Accuracy

Every "works"/"does NOT work" claim re-verified against origin/release-r1 parser source:

  • JOIN 5 types (FromParser.scala:43-49); UNION ALL token only, no bare UNION (operator/package.scala:77); IN-literal-only (WhereParser.scala:240-242); Exists commented out (cond/package.scala:53); all 8 WITH keywords non-CTE; NTILE/LAG/LEAD zero hits; Except is projection-exclusion not set operator (Select.scala:118-120); Epic-14 functions present (aggregate/package.scala).
  • Two labelling traps handled: SELECT * EXCEPT(cols) projection (works) vs EXCEPT set operator (does not); NTILE/LAG/LEAD are positional/tiling, NOT "percentile-distinct".

Forward-declared (NOT live yet)

  • joins.md (17.1) and ../client/federation_operator_guide.md (16.6/17.2) — targets not on release-r1; plain text + <!-- pending --> comment. Launch gate (17.8) strips markers once merged.

Web-only carve-out (A3)

DBeaver/Superset/Grafana have no documentation/ MD twin → intentionally web-only; MD inbound links land only on the existing SQL/client twins (dql_statements.md, arrow_flight_sql.md).

🤖 Generated with Claude Code

…raming)

Story 17.6 (Epic 17, Layer 0). MD mirror of the canonical web
/known-limitations/ page: exactly what SQL works in R1, what's coming in
R2a/R2b/R3+, and the per-tool BI workaround (Tableau / Power BI / Looker /
Metabase) for the subquery/CTE gap. Token-for-token parity with the web
MDX. Every works/does-not-work claim verified against release-r1 source.

- NEW documentation/sql/known_limitations.md
- UPDATE documentation/sql/README.md: index link after DQL Support
- Inbound one-liners on documentation/sql/dql_statements.md and
  documentation/client/arrow_flight_sql.md
- Outbound links to joins.md (17.1) and ../client/federation_operator_guide.md
  (16.6/17.2) forward-declared until those targets land on release-r1

Closed Issue #139

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant