Skip to content

docs: Superset 6.1 documentation catch-up — batch 3#39445

Merged
michael-s-molina merged 2 commits intomasterfrom
docs/superset-6.1-catchup-3
Apr 29, 2026
Merged

docs: Superset 6.1 documentation catch-up — batch 3#39445
michael-s-molina merged 2 commits intomasterfrom
docs/superset-6.1-catchup-3

Conversation

@rusackas
Copy link
Copy Markdown
Member

SUMMARY

Third batch of documentation updates for features merged after 6.0. Continues from #39440 and #39441.

  • Node.js v22 prerequisite (development-setup.md) — updates the frontend development prerequisite from Node.js v20 to v22 LTS (PR feat!: upgrade project's Node version to v22 #37223).

  • masked_encrypted_extra in import/export (importing-exporting-datasources.mdx) — documents that sensitive connection parameters stored in masked_encrypted_extra (service account JSON, OAuth tokens, encrypted credentials) are now included when exporting and importing database connections (PR feat: support for import/export masked_encrypted_extra (frontend) #38078). Includes a note about SECRET_KEY requirements on the receiving instance.

  • get_samples() access control (security.mdx) — adds a note in the SQL Execution Security section that the sample data endpoint now enforces datasource-level permissions, closing a prior gap where under-privileged users could fetch sample rows (PR fix(security): enforce datasource access control in get_samples() #36550).

  • Natural language time range expressions (exploring-data.mdx) — documents the range of natural language expressions supported in the Custom time range picker, including the new "first of" expressions (first day of this week, first day of this month, first week of this year, etc.) added in PR feat(dates): adding handling for first of #37098.

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

N/A — documentation-only changes.

TESTING INSTRUCTIONS

  • Review each added section for accuracy
  • Optionally: cd docs && npm start to verify MDX renders correctly

ADDITIONAL INFORMATION

  • Has associated issue:
  • Required feature flags:
  • Changes UI
  • Includes DB Migration
  • Introduces new feature or API
  • Removes existing feature or API

Note: database engine pages (docs/docs/databases/) are auto-generated at build time and gitignored — Athena dynamic schema (#36003) and StarRocks catalog (#37026) updates require changes to the Python engine specs rather than the MDX files.

Fourth PR in the 6.1 docs series (alongside #39422, #39440, #39441).

- development-setup.md: update Node.js prerequisite from v20 to v22 LTS
  (PR #37223 — project minimum Node version upgraded)
- importing-exporting-datasources.mdx: document that masked_encrypted_extra
  (sensitive connection parameters like service account JSON) is now included
  in database import/export (PR #38078)
- security.mdx: add note that get_samples() enforces datasource-level access
  control, closing prior gap where unprivileged users could fetch sample rows
  (PR #36550)
- exploring-data.mdx: document natural language time range expressions
  including new "first of" expressions (first day/week of month/quarter/year)
  supported in the Custom time range picker (PR #37098)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added the doc Namespace | Anything related to documentation label Apr 17, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 17, 2026

Deploy Preview for superset-docs-preview ready!

Name Link
🔨 Latest commit fbd27e7
🔍 Latest deploy log https://app.netlify.com/projects/superset-docs-preview/deploys/69f2447dbc6a380008f3b5a4
😎 Deploy Preview https://deploy-preview-39445--superset-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Comment thread docs/developer_docs/contributing/development-setup.md
@rusackas rusackas marked this pull request as ready for review April 17, 2026 17:18
Copy link
Copy Markdown
Contributor

@bito-code-review bito-code-review Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review Agent Run #0f4a92

Actionable Suggestions - 1
  • docs/docs/using-superset/exploring-data.mdx - 1
Review Details
  • Files reviewed - 3 · Commit Range: 4cf8f82..4cf8f82
    • docs/admin_docs/configuration/importing-exporting-datasources.mdx
    • docs/admin_docs/security/security.mdx
    • docs/docs/using-superset/exploring-data.mdx
  • Files skipped - 1
    • docs/developer_docs/contributing/development-setup.md - Reason: Filter setting
  • Tools
    • Whispers (Secret Scanner) - ✔︎ Successful
    • Detect-secrets (Secret Scanner) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

  • /review - Manually triggers a full AI review.

  • /pause - Pauses automatic reviews on this pull request.

  • /resume - Resumes automatic reviews.

  • /resolve - Marks all Bito-posted review comments as resolved.

  • /abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Superset You can customize the agent settings here or contact your Bito workspace admin at evan@preset.io.

Documentation & Help

AI Code Review powered by Bito Logo


### Time Range Natural Language Expressions

The **Custom** time range picker accepts natural language expressions alongside specific dates. Superset supports a range of expressions including:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documentation inaccuracy

The documentation refers to the 'Custom' time range picker, but natural language expressions are actually supported in the 'Advanced' time range picker, which provides text inputs for 'since' and 'until' fields. The 'Custom' picker uses UI controls for building ranges. Please update the title and description to say 'Advanced' instead of 'Custom'.

Code Review Run #0f4a92


Should Bito avoid suggestions like this for future reviews? (Manage Rules)

  • Yes, avoid them

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch — natural language expressions like Last 7 days and 30 days ago go in the Advanced picker (text inputs for since/until), not Custom (DatePicker/Radio/Select UI controls). This PR is already merged so I'll send the rename through in a follow-up PR to master.

@rusackas rusackas marked this pull request as draft April 19, 2026 19:30
@michael-s-molina michael-s-molina marked this pull request as ready for review April 29, 2026 14:22
@dosubot dosubot Bot added doc:developer Developer documentation doc:user User / Superset documentation labels Apr 29, 2026
@michael-s-molina michael-s-molina merged commit b4f5959 into master Apr 29, 2026
65 checks passed
@michael-s-molina michael-s-molina deleted the docs/superset-6.1-catchup-3 branch April 29, 2026 18:00
michael-s-molina added a commit that referenced this pull request Apr 29, 2026
Co-authored-by: Superset Dev <dev@superset.apache.org>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Michael S. Molina <70410625+michael-s-molina@users.noreply.github.com>
(cherry picked from commit b4f5959)
@bito-code-review
Copy link
Copy Markdown
Contributor

Bito Automatic Review Skipped – PR Already Merged

Bito scheduled an automatic review for this pull request, but the review was skipped because this PR was merged before the review could be run.
No action is needed if you didn't intend to review it. To get a review, you can type /review in a comment and save it

bestlong pushed a commit to bestlong/superset that referenced this pull request May 7, 2026
Co-authored-by: Superset Dev <dev@superset.apache.org>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Michael S. Molina <70410625+michael-s-molina@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc:developer Developer documentation doc:user User / Superset documentation doc Namespace | Anything related to documentation size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants