docs: show Developer Portal in global navigation #37313

rusackas · 2026-01-21T21:04:00Z

SUMMARY

Enable the Developer Portal navigation item in the global navbar. The section was previously hidden via hideFromNav: true in docs/versions-config.json while the content was being developed, but is now ready for public visibility.

This makes the Developer Portal accessible from the top navigation bar, alongside Documentation and Community Resources.

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

Before: Developer Portal not visible in navbar
After: Developer Portal appears in navbar with dropdown menu (Overview, Extensions, Testing, Guidelines, Contributing)

TESTING INSTRUCTIONS

Build docs locally: cd docs && npm run build
Start local preview: npm run serve
Verify the "Developer Portal" dropdown appears in the navbar between "Community Resources" and "Get Started"
Click the dropdown items and verify they navigate to the correct pages

ADDITIONAL INFORMATION

Has associated issue:
Required feature flags:
Changes UI
Includes DB Migration (follow approval process in SIP-59)
- Migration is atomic, supports rollback & is backwards-compatible
- Confirm DB migration upgrade and downgrade tested
- Runtime estimates and downtime expectations provided
Introduces new feature or API
Removes existing feature or API

🤖 Generated with Claude Code

Enable the Developer Portal navigation item in the global navbar. The section was previously hidden via hideFromNav flag while the content was being developed, but is ready for visibility. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

codeant-ai-for-open-source · 2026-01-21T21:04:06Z

CodeAnt AI is reviewing your PR.

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

bito-code-review · 2026-01-21T21:04:10Z

Bito Automatic Review Skipped - Files Excluded

Bito didn't auto-review this change because all changed files are in the exclusion list for automatic reviews. No action is needed if you didn't intend for the agent to review it. Otherwise, to manually trigger a review, type /review in a comment and save.
You can change the excluded files settings here, or contact your Bito workspace admin at evan@preset.io.

codeant-ai-for-open-source · 2026-01-21T21:05:11Z

Sequence Diagram

This PR flips the docs configuration to expose the "Developer Portal" in the global navbar. The diagram shows the build/runtime config being read and the user discovering and navigating to the Developer Portal from the top navigation.

sequenceDiagram
    participant User
    participant Browser
    participant DocsSite
    participant ConfigFile

    Browser->>DocsSite: Request site (page load / build)
    DocsSite->>ConfigFile: Read versions-config.json (hideFromNav: false)
    ConfigFile-->>DocsSite: Developer Portal enabled
    DocsSite-->>Browser: Render navbar with "Developer Portal" dropdown
    User->>Browser: Click "Developer Portal" -> select dropdown item
    Browser->>DocsSite: Navigate to selected Developer Portal page
    DocsSite-->>Browser: Serve Developer Portal content

Generated by CodeAnt AI

codeant-ai-for-open-source · 2026-01-21T21:05:14Z

CodeAnt AI finished reviewing your PR.

The navbar item for Extensions was referencing 'extensions/architectural-principles' but the actual doc file is 'extensions/architecture'. This caused the build to fail when the Developer Portal became visible in the navbar. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

netlify · 2026-01-21T22:02:13Z

✅ Deploy Preview for superset-docs-preview ready!

Name	Link
🔨 Latest commit	`18dc0cf`
🔍 Latest deploy log	https://app.netlify.com/projects/superset-docs-preview/deploys/69725842d417830008dd7d42
😎 Deploy Preview	https://deploy-preview-37313--superset-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

Update links that pointed to the old /docs/configuration/databases path to use the new /docs/databases path with correct anchors. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

bito-code-review

Code Review Agent Run #773956

Actionable Suggestions - 1

docs/docs/configuration/timezones.mdx - 1
- Broken documentation link · Line 23-23

Additional Suggestions - 1

docs/docs/configuration/timezones.mdx - 1

Spelling error in docs · Line 23-23

The term 'serializd' is a spelling error; it should be 'serialized' to correctly describe the JSON serialization process.

Code suggestion

 @@ -23,1 +23,1 @@
-The challenge however lies with the slew of [database engines](/docs/databases#installing-drivers-in-docker) which Apache Superset supports and various inconsistencies between their [Python Database API (DB-API)](https://www.python.org/dev/peps/pep-0249/) implementations combined with the fact that we use [Pandas](https://pandas.pydata.org/) to read SQL into a DataFrame prior to serializing to JSON. Regrettably Pandas ignores the DB-API [type_code](https://www.python.org/dev/peps/pep-0249/#type-objects) relying by default on the underlying Python type returned by the DB-API. Currently only a subset of the supported database engines work correctly with Pandas, i.e., ensuring timestamps without an explicit timestamp are serializd to JSON with the server timezone, thus guaranteeing the client will display timestamps in a consistent manner irrespective of the client's timezone.
+The challenge however lies with the slew of [database engines](/docs/databases#installing-drivers-in-docker) which Apache Superset supports and various inconsistencies between their [Python Database API (DB-API)](https://www.python.org/dev/peps/pep-0249/) implementations combined with the fact that we use [Pandas](https://pandas.pydata.org/) to read SQL into a DataFrame prior to serializing to JSON. Regrettably Pandas ignores the DB-API [type_code](https://www.python.org/dev/peps/pep-0249/#type-objects) relying by default on the underlying Python type returned by the DB-API. Currently only a subset of the supported database engines work correctly with Pandas, i.e., ensuring timestamps without an explicit timestamp are serialized to JSON with the server timezone, thus guaranteeing the client will display timestamps in a consistent manner irrespective of the client's timezone.

Review Details

Files reviewed - 5 · Commit Range: f9e0634..d4e8513
- docs/docs/configuration/timezones.mdx
- docs/docs/faq.mdx
- docs/docs/installation/kubernetes.mdx
- docs/docs/quickstart.mdx
- docs/docusaurus.config.ts
Files skipped - 2
- docs/src/data/databases.json - Reason: Filter setting
- docs/versions-config.json - Reason: Filter setting
Tools
- Eslint (Linter) - ✔︎ Successful
- 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

docs/docs/configuration/timezones.mdx

michael-s-molina · 2026-01-22T11:41:28Z

When I click on Developer Portal -> Extensions it's redirecting me to Architecture but I think it should be Overview.

michael-s-molina

@rusackas I left a non-blocking comment that would be nice to address before merging.

The Extensions link in the Developer Portal navbar should go to the overview page, not directly to the architecture page. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

bito-code-review · 2026-01-22T18:07:14Z

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

pull-request-size bot added the size/XS label Jan 21, 2026

github-actions bot added the doc Namespace | Anything related to documentation label Jan 21, 2026

rusackas requested a review from michael-s-molina January 21, 2026 21:47

fix(docs): update broken links to /docs/configuration/databases

d4e8513

Update links that pointed to the old /docs/configuration/databases path to use the new /docs/databases path with correct anchors. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

pull-request-size bot added size/S and removed size/XS labels Jan 21, 2026

bito-code-review bot reviewed Jan 21, 2026

View reviewed changes

docs/docs/configuration/timezones.mdx Show resolved Hide resolved

michael-s-molina approved these changes Jan 22, 2026

View reviewed changes

fix(docs): link Extensions nav item to overview instead of architecture

18dc0cf

The Extensions link in the Developer Portal navbar should go to the overview page, not directly to the architecture page. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

rusackas merged commit 9fabd7f into master Jan 22, 2026
64 checks passed

rusackas deleted the feat/show-developer-portal-nav branch January 22, 2026 17:41

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: show Developer Portal in global navigation #37313

docs: show Developer Portal in global navigation #37313

Uh oh!

rusackas commented Jan 21, 2026

Uh oh!

codeant-ai-for-open-source bot commented Jan 21, 2026

Uh oh!

bito-code-review bot commented Jan 21, 2026 •

edited

Loading

Uh oh!

codeant-ai-for-open-source bot commented Jan 21, 2026

Uh oh!

codeant-ai-for-open-source bot commented Jan 21, 2026

Uh oh!

netlify bot commented Jan 21, 2026 •

edited

Loading

Uh oh!

bito-code-review bot left a comment •

edited

Loading

Uh oh!

Uh oh!

michael-s-molina commented Jan 22, 2026

Uh oh!

michael-s-molina left a comment

Uh oh!

Uh oh!

bito-code-review bot commented Jan 22, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

docs: show Developer Portal in global navigation #37313

docs: show Developer Portal in global navigation #37313

Uh oh!

Conversation

rusackas commented Jan 21, 2026

SUMMARY

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

TESTING INSTRUCTIONS

ADDITIONAL INFORMATION

Uh oh!

codeant-ai-for-open-source bot commented Jan 21, 2026

Thanks for using CodeAnt! 🎉

Uh oh!

bito-code-review bot commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codeant-ai-for-open-source bot commented Jan 21, 2026

Sequence Diagram

Uh oh!

codeant-ai-for-open-source bot commented Jan 21, 2026

Uh oh!

netlify bot commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for superset-docs-preview ready!

Uh oh!

bito-code-review bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Code Review Agent Run #773956

Uh oh!

Uh oh!

michael-s-molina commented Jan 22, 2026

Uh oh!

michael-s-molina left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

bito-code-review bot commented Jan 22, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

bito-code-review bot commented Jan 21, 2026 •

edited

Loading

netlify bot commented Jan 21, 2026 •

edited

Loading

bito-code-review bot left a comment •

edited

Loading