Skip to content

docs: rewrite customer facing timezones docs draft#874

Draft
almeidabbm wants to merge 18 commits into
mainfrom
docs/timezones-guide-rewrite
Draft

docs: rewrite customer facing timezones docs draft#874
almeidabbm wants to merge 18 commits into
mainfrom
docs/timezones-guide-rewrite

Conversation

@almeidabbm

@almeidabbm almeidabbm commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Rewrites the customer-facing timezones guide to match the shipped Timezone v2 beta behaviour.

What's in here

  • Full rewrite into two parts, Setup and Daily use, in GA voice with a single Beta callout.
  • Documents the shipped model: data timezone vs project timezone, the chart timezone picker (Project / User / Specific), the resolved-timezone badge, the dimension timezone indicators, and the convert_timezone: false opt-out.
  • Adds "Which timezone wins" (the real resolution order), calendar vs timestamp shifting, MIN/MAX metric formatting, and the "Project time zone in filter inputs" project setting.
  • Daylight-saving section now has worked hourly charts (light + dark) showing the fall-back doubled hour and the spring-forward missing hour.
  • Verified end-to-end against the current source (resolveQueryTimezone.ts, formatting.ts, the chart picker and dimension-indicator components).

Relates to: https://linear.app/lightdash/issue/GLITCH-457/publish-customer-facing-timezone-docs-at-default-flip

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

Status

✅ Fixed 4 misplaced images

@mintlify

mintlify Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Jun 19, 2026, 10:47 AM

Automatically fixed image location issues.

Co-Authored-By: GitHub Actions <github-actions[bot]@users.noreply.github.com>
Adds .local/ and .worktrees/ so per-task working memory and worktrees never get committed in this repo.
The draft reused the date-filter screenshot but never covered the 'Use project time zone in date filter inputs' project setting, and overclaimed that absolute filters behave the same for every viewer. That is false for time-of-day inputs until the toggle is on.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Verified the draft against current source. Corrects the date-filter toggle label to the real UI string, and fixes the profile-timezone note: scheduled deliveries run as their creator, so a User-timezone chart uses the creator's profile timezone.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Renames the top-level section headings to read as plain prose instead of Part 1/Part 2/Appendix labels.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Defines the 'resolved timezone' term where the resolution rules are explained, moves 'Choosing a chart's timezone' ahead of the sections that depend on it, drops the end-of-guide TL;DR checklist, and simplifies the example heading.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Replaces 'wall-clock time' with 'local time in the resolved timezone' in the DST section and 'wall-clock values' with 'fixed calendar dates' for DATE columns, matching the guide's vocabulary.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Adds hourly bar charts (light + dark) for the fall-back doubled hour and spring-forward missing hour. Switches the enablement note to the standard Beta callout, restores the Setup/Daily use section headings with intro links, and trims the daylight-saving copy.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

@linear-code

linear-code Bot commented Jun 19, 2026

Copy link
Copy Markdown

GLITCH-462

GLITCH-457

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Project timezone does not control delivery send-time (links to the delivery default-timezone setting). Embed timezone is a direct iframe/URL ?timezone= param (not the React SDK) on embedded dashboards, per GLITCH-488.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Renames 'Annotate edge-case columns' to 'Opt a column out of timezone conversion' and shows the convert_timezone: false example for dbt <=1.9, dbt 1.10+/Fusion, and Lightdash YAML.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Reflects the timezone picker moving into the Run query settings dropdown (new open-dropdown screenshots), adds the Project time zone in filter inputs setting image, crops the dimension indicator to the relevant region, fixes the chart-timezone anchor to clean ASCII, and standardizes TIMESTAMP/DATE formatting.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Removes AI-tell phrasing and superlatives, de-fluffs the intro, drops the shaky daily DST bar-height claim, and fixes the Embedded dashboards naming. No technical content changed.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Trims redundant phrasing in the worked example (now a comparison table), dashboards, embedded dashboards, cell-click, day grouping, profile timezone, and troubleshooting. No technical content changed.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Replaces the dense symptom table with an AccordionGroup, makes each entry self-contained, and varies the hedging (usually / could be / probably / may have / might be / likely) instead of asserting causes.
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

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