Environment Variables Migration#444
Merged
Ethan-Arrowood merged 4 commits intomajor-version-reorgfrom Feb 25, 2026
Merged
Conversation
25 tasks
Ethan-Arrowood
force-pushed
the
migration/environment-variables
branch
from
6bc5898 to
aca6fec
Compare
Adds the Environment Variables section focused on the built-in `loadEnv` plugin. Harper-level env var configuration (naming conventions, HDB_CONFIG, HARPER_DEFAULT_CONFIG, HARPER_SET_CONFIG) is intentionally deferred to the Configuration section, with research notes captured in the migration map. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Ethan-Arrowood
force-pushed
the
migration/environment-variables
branch
from
aca6fec to
28e35fb
Compare
🚀 Preview DeploymentYour preview deployment is ready! 🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-444 This preview will update automatically when you push new commits. |
cb1kenobi
reviewed
Feb 24, 2026
reference_versioned_docs/version-v4/environment-variables/overview.md
Outdated
Show resolved
Hide resolved
cb1kenobi
reviewed
Feb 24, 2026
reference_versioned_docs/version-v4/environment-variables/overview.md
Outdated
Show resolved
Hide resolved
Co-authored-by: Chris Barber <chris@harperdb.io>
🚀 Preview DeploymentYour preview deployment is ready! 🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-444 This preview will update automatically when you push new commits. |
🚀 Preview DeploymentYour preview deployment is ready! 🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-444 This preview will update automatically when you push new commits. |
kriszyp
approved these changes
Feb 25, 2026
🧹 Preview CleanupThe preview deployment for this PR has been removed. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Environment Variables Migration
Summary
Migration of the Environment Variables section from
versioned_docs/into the newreference_versioned_docs/version-v4/reference structure.Files Created
reference_versioned_docs/version-v4/environment-variables/overview.mdmigration-context/link-placeholders/environment-variables-link-placeholders.mdFiles Updated
reference_versioned_sidebars/version-v4-sidebars.json— added Environment Variables categoryv4-docs-migration-map.md— updated status to In Progress; added research notes to Configuration sectionSource Files Used
reference_versioned_docs/version-v4/environment-variables/overview.mdversioned_docs/version-4.7/reference/components/built-in-extensions.md(primary —loadEnvsection)versioned_docs/version-4.5/developers/components/built-in.md(for v4.5 feature introduction)release_notes/4.5.0.md(confirmedloadEnvintroduction date)Scope Decision
This section covers the
loadEnvbuilt-in plugin only. Harper-level environment variable configuration (naming conventions,HDB_CONFIG,HARPER_DEFAULT_CONFIG,HARPER_SET_CONFIG) belongs in the top-level Configuration section. All researched content for those features has been captured in notes on thereference/configuration/overview.mdentry in the migration map, ready for the Configuration section migration.Version Annotations Added
High Confidence (Confirmed via release notes)
loadEnv: Added in v4.5.0HARPER_DEFAULT_CONFIG/HARPER_SET_CONFIG: Added in v4.7.2 (captured in migration map notes for Configuration section)Link Placeholders Created
See
migration-context/link-placeholders/environment-variables-link-placeholders.mdfor complete list.Summary:
overview.md— 2 toconfiguration/overview.md, 2 tocomponents/overview.mdConflicts & Questions for Human Review
Uncertainties
loadEnvas both an "extension" (v4.5 docs) and a "plugin" (v4.7 docs). The user updated the language to "plugin" — this is consistent with the v4.7 terminology direction.Migration Map Status
Updated status for Environment Variables
overview.mdto "In Progress"Checklist for Human Reviewer
loadEnvversion annotation (v4.5.0) is correctloadEnvonly here, Harper config env vars in Configuration section