Altinity / Altinity/altinity-sql-browser

Document the supported-browser matrix (browsers, ClickHouse versions, IdP requirements)

Offen
#71 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

documentation
Vorherrschende Sprache
TypeScript
Sterne
8
Forks
2
Ø Merge
1 Std. 34 Min.
Gemergte PRs (30 T.)
6

Beschreibung

Part of #68 (Roadmap to 1.0.0) — release-blocker.

Problem

The README never states which browsers/versions are supported, nor the supported ClickHouse versions or IdP requirements. A 1.0 cannot ship silent on this — especially given the html{zoom} reliance (see the zoom de-risk + WebKit-e2e issues), which makes the supported-engine set a real, non-obvious constraint.

Ask

Add a concise support matrix / system-requirements section to the README:

  • Browsers + minimum versions (desktop Chrome/Edge/Firefox; Safari status pending the WebKit decision). Note desktop-only if that's the call (no responsive CSS today).
  • ClickHouse server versions (incl. Antalya vs OSS + JWT-verify sidecar notes).
  • IdP/OAuth requirements (PKCE public client preferred; the client_secret caveat → link SECURITY.md).
Acceptance
  • README has a clear, scannable support matrix.
  • Browser row reflects the WebKit/Safari decision from the related issues.

Folded in from the roadmap (#68) nice-to-haves:

  • State the desktop-only stance explicitly — there is no responsive CSS today (no @media, fixed px, overflow:hidden on html/body). The matrix should say "desktop browsers" (or add a minimal narrow-viewport fallback) so a phone/tablet user isn't surprised by a silently-broken layout.
ClickHouse 24.8 decision (#627)

ClickHouse 24.8 is Limited support: query execution and Table results are
supported. Typed result features such as automatic charts, KPI interpretation,
logs detection, and type-aware formatting may be unavailable because 24.8 does
not provide result metadata in the streaming format used by SQL Browser.

SQL Browser does not infer ClickHouse result types from returned values.
Do not describe 24.8 as full-fidelity support. #627 is the production
compatibility implementation and live-verification record.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne mit README und prüfe SECURITY.md, die verwandten WebKit/Safari- und Zoom-Issues sowie #627 für die Kompatibilitätsentscheidung zu ClickHouse 24.8. Dokumentiere die Browser-Matrix, die Festlegung auf ausschließlich Desktop, die Unterstützung und Einschränkungen von ClickHouse sowie die Anforderungen an den IdP, wobei die Safari-Zeile mit der WebKit-Entscheidung übereinstimmen muss.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
clickhouse
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
55/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.