Skip to content

docs: add environment variables section to setup/teardown docs#779

Merged
Kitenite merged 2 commits intomainfrom
update-docs-w-env-variables
Jan 16, 2026
Merged

docs: add environment variables section to setup/teardown docs#779
Kitenite merged 2 commits intomainfrom
update-docs-w-env-variables

Conversation

@Kitenite
Copy link
Copy Markdown
Collaborator

@Kitenite Kitenite commented Jan 16, 2026

Summary

  • Add "Environment Variables" section to setup-teardown-scripts documentation
  • Document SUPERSET_ROOT_PATH and SUPERSET_WORKSPACE_NAME variables provided by Superset
  • Include example usage showing how to copy root .env to workspace

Test plan

  • Verify docs site builds successfully
  • Review rendered documentation for formatting accuracy

Note

Adds clear guidance on environment variables available to setup/teardown scripts and a minimal usage example.

  • New "Environment Variables" section in setup-teardown-scripts.mdx documenting SUPERSET_ROOT_PATH and SUPERSET_WORKSPACE_NAME with a bash example
  • Updates apps/docs/tsconfig.json to include an additional .next/dev/dev/types/**/*.ts path for type checking

Written by Cursor Bugbot for commit 5cb8a51. This will update automatically on new commits. Configure here.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jan 16, 2026

📝 Walkthrough

Walkthrough

This PR adds an "Environment Variables" section to the setup-teardown-scripts documentation, detailing SUPERSET_ROOT_PATH and SUPERSET_WORKSPACE_NAME with configuration examples, and reformats the TypeScript configuration file with improved formatting and additional type path includes.

Changes

Cohort / File(s) Summary
Documentation
apps/docs/content/docs/setup-teardown-scripts.mdx
Added "Environment Variables" section documenting SUPERSET_ROOT_PATH and SUPERSET_WORKSPACE_NAME with descriptions and Bash configuration example snippet
Configuration
apps/docs/tsconfig.json
Reformatted with improved indentation and multi-line array expansion; added .next/dev/dev/types/**/*.ts to include paths

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Poem

🐰 Twitches whiskers with delight
Docs are polished, clean and bright,
Config paths aligned just right,
Environment secrets brought to light,
A rabbit's joy—pure markdown delight! 🌿

🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Description check ❓ Inconclusive The pull request description covers the main changes and includes a test plan, but lacks required sections from the template such as Related Issues and Type of Change. Complete the description by adding the 'Related Issues' section and selecting the appropriate 'Type of Change' (likely 'Documentation'). Ensure all template sections are addressed.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely describes the main change: adding an environment variables section to the setup/teardown documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@apps/docs/tsconfig.json`:
- Around line 40-42: Remove the duplicated include pattern
".next/dev/dev/types/**/*.ts" from the tsconfig "include" array: locate the
include entries that contain ".next/types/**/*.ts", ".next/dev/types/**/*.ts",
and ".next/dev/dev/types/**/*.ts" and delete the offending
".next/dev/dev/types/**/*.ts" entry so the include list matches the standard
Next.js generated types patterns.

Comment thread apps/docs/tsconfig.json Outdated
Comment on lines +40 to +42
".next/types/**/*.ts",
".next/dev/types/**/*.ts",
".next/dev/dev/types/**/*.ts"
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.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check if .next/dev/dev/ path structure exists in the docs app or is referenced elsewhere

# Search for any references to dev/dev pattern in tsconfig files
echo "=== Searching for 'dev/dev' pattern in tsconfig files ==="
rg -n "dev/dev" -g "tsconfig*.json"

# Check other tsconfig files in the repo for comparison of .next include patterns
echo -e "\n=== Checking .next include patterns in other tsconfig files ==="
rg -n "\.next.*types" -g "tsconfig*.json"

# Look at the actual tsconfig.json file in the docs app
echo -e "\n=== Content of apps/docs/tsconfig.json ==="
cat -n apps/docs/tsconfig.json

Repository: superset-sh/superset

Length of output: 2011


Remove the duplicated .next/dev/dev/types/**/*.ts path from the include array.

The path on line 42 contains duplicated dev directory segments. This pattern does not exist in any other TypeScript configuration in the repository (all other apps only include .next/types/**/*.ts), and it does not match the standard Next.js directory structure for generated types. This appears to be a copy-paste error and should be removed.

🤖 Prompt for AI Agents
In `@apps/docs/tsconfig.json` around lines 40 - 42, Remove the duplicated include
pattern ".next/dev/dev/types/**/*.ts" from the tsconfig "include" array: locate
the include entries that contain ".next/types/**/*.ts",
".next/dev/types/**/*.ts", and ".next/dev/dev/types/**/*.ts" and delete the
offending ".next/dev/dev/types/**/*.ts" entry so the include list matches the
standard Next.js generated types patterns.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jan 16, 2026

🚀 Preview Deployment

🔗 Preview Links

Service Status Link
Neon Database (Neon) View Branch
Fly.io Electric (Fly.io) View App
Vercel API (Vercel) Open Preview
Vercel Web (Vercel) Open Preview
Vercel Marketing (Vercel) Open Preview
Vercel Admin (Vercel) Open Preview
Vercel Docs (Vercel) Open Preview

Preview updates automatically with new commits

Document the environment variables available to setup scripts, including
SUPERSET_ROOT_PATH and SUPERSET_WORKSPACE_NAME provided by Superset.
@Kitenite Kitenite merged commit c4ef5d2 into main Jan 16, 2026
13 checks passed
@Kitenite Kitenite deleted the update-docs-w-env-variables branch January 16, 2026 21:05
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

This is the final PR Bugbot will review for you during this billing cycle

Your free Bugbot reviews will reset on February 14

Details

You are on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

Comment thread apps/docs/tsconfig.json
".next/types/**/*.ts",
".next/dev/types/**/*.ts"
".next/dev/types/**/*.ts",
".next/dev/dev/types/**/*.ts"
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Unrelated tsconfig change with suspicious duplicate path

Low Severity

The include array now contains .next/dev/dev/types/**/*.ts with a suspicious double dev/dev path pattern. This change is unrelated to the PR's stated purpose of documenting environment variables. Other apps in this monorepo only include .next/types/**/*.ts. The duplicate dev directory likely indicates a typo or an accidentally committed change from a debugging session.

Fix in Cursor Fix in Web

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