Skip to content

Story 17.7 — Privacy/telemetry doc: AC-7 hedge correction + de-duplicate MD telemetry docs (download analytics rename) #136

Description

@fupelaqu

Epic 17 — R1 Documentation & Marketing · Story 17.7 (Layer 0).

Reconciles the customer privacy/telemetry doc on R1 launch day in the elasticsql MD docs tree. Not a re-author — Story 15.6 already shipped the content; this is the de-duplication + AC-7 correction half (the web source-of-truth half is tracked in softclient4es-web).

Changes (documentation/)

  • AC-7 hedge correction in documentation/client/telemetry.md (:119): the stale 15.6 hedge ("a dedicated driver property … may also be offered … until then use HOCON/-D") is replaced with the now-accurate statement — JDBC accepts ?telemetry=false directly on the JDBC URL (IMPLEMENTED, ConnectionUrl.scala:54,102-115); ADBC has no equivalent connection option, HOCON/-D only (ElasticAdbcConnection.scala:125). The daily-ping key softclient4es.telemetry.enabled is MERGED (reference.conf:28-31, TelemetryConfig.scala:38) — no PROPOSED marker survives. Mirrors the web source-of-truth edit byte-for-byte.
  • D1c(i) de-duplication: git mv documentation/sql/telemetry.md → documentation/client/download_analytics.md, H1 → # Download Analytics, download-analytics facts kept verbatim, intro reworked to link the canonical [Telemetry & Privacy](telemetry.md) sibling. Resolves the launch-time defect where two MD docs shared the # Telemetry & Privacy H1 and sql/README.md linked both with identical labels.
  • README fixes (text-anchored): documentation/sql/README.md now has exactly one [Telemetry & Privacy](../client/telemetry.md) + one [Download Analytics](../client/download_analytics.md); documentation/client/README.md gains the [Download Analytics](download_analytics.md) bullet.

Verification

Docs-only (no sbt/compile). Stale hedge dedicated driver property = 0 hits in client/telemetry.md; exactly one [Telemetry & Privacy] label per README; per-surface opt-out one-liners (adbc/arrow_flight_sql/repl) verified present; retention (13 months) + contact (sales@softclient4es.com) parity with the web source-of-truth confirmed.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions