From 12020151512aaea38da2d391be1bf77c77398942 Mon Sep 17 00:00:00 2001 From: Ethan Arrowood Date: Thu, 28 May 2026 12:49:57 -0600 Subject: [PATCH 1/2] docs: clarify loadEnv files option is required Add a Configuration table to the loadEnv reference page (current and v4 versioned) that explicitly marks `files` as a required option, preventing the incorrect `loadEnv: true` usage pattern. Co-Authored-By: Claude Sonnet 4.6 --- reference/environment-variables/overview.md | 7 +++++++ .../version-v4/environment-variables/overview.md | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/reference/environment-variables/overview.md b/reference/environment-variables/overview.md index 0c72b83b..8031bb98 100644 --- a/reference/environment-variables/overview.md +++ b/reference/environment-variables/overview.md @@ -13,6 +13,13 @@ Harper supports loading environment variables in Harper applications `process.en If you are looking for information on how to configure your Harper installation using environment variables, see [Configuration](../configuration/overview.md) section for more information. ::: +## Configuration + +| Option | Type | Required | Description | +|--------|------|----------|-------------| +| `files` | `string \| string[]` | **Yes** | Path(s) or glob pattern(s) to the env file(s) to load. | +| `override` | `boolean` | No | If `true`, loaded values override existing environment variables. Defaults to `false`. | + ## Basic Usage ```yaml diff --git a/reference_versioned_docs/version-v4/environment-variables/overview.md b/reference_versioned_docs/version-v4/environment-variables/overview.md index 0c72b83b..8031bb98 100644 --- a/reference_versioned_docs/version-v4/environment-variables/overview.md +++ b/reference_versioned_docs/version-v4/environment-variables/overview.md @@ -13,6 +13,13 @@ Harper supports loading environment variables in Harper applications `process.en If you are looking for information on how to configure your Harper installation using environment variables, see [Configuration](../configuration/overview.md) section for more information. ::: +## Configuration + +| Option | Type | Required | Description | +|--------|------|----------|-------------| +| `files` | `string \| string[]` | **Yes** | Path(s) or glob pattern(s) to the env file(s) to load. | +| `override` | `boolean` | No | If `true`, loaded values override existing environment variables. Defaults to `false`. | + ## Basic Usage ```yaml From f68e569acc29fb77aa8b1ff73ee33d0e1a54e5a9 Mon Sep 17 00:00:00 2001 From: Ethan Arrowood Date: Thu, 28 May 2026 15:16:09 -0600 Subject: [PATCH 2/2] chore: format environment-variables overview with prettier Co-Authored-By: Claude Sonnet 4.6 --- reference/environment-variables/overview.md | 8 ++++---- .../version-v4/environment-variables/overview.md | 8 ++++---- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/reference/environment-variables/overview.md b/reference/environment-variables/overview.md index 8031bb98..d30d004b 100644 --- a/reference/environment-variables/overview.md +++ b/reference/environment-variables/overview.md @@ -15,10 +15,10 @@ If you are looking for information on how to configure your Harper installation ## Configuration -| Option | Type | Required | Description | -|--------|------|----------|-------------| -| `files` | `string \| string[]` | **Yes** | Path(s) or glob pattern(s) to the env file(s) to load. | -| `override` | `boolean` | No | If `true`, loaded values override existing environment variables. Defaults to `false`. | +| Option | Type | Required | Description | +| ---------- | -------------------- | -------- | -------------------------------------------------------------------------------------- | +| `files` | `string \| string[]` | **Yes** | Path(s) or glob pattern(s) to the env file(s) to load. | +| `override` | `boolean` | No | If `true`, loaded values override existing environment variables. Defaults to `false`. | ## Basic Usage diff --git a/reference_versioned_docs/version-v4/environment-variables/overview.md b/reference_versioned_docs/version-v4/environment-variables/overview.md index 8031bb98..d30d004b 100644 --- a/reference_versioned_docs/version-v4/environment-variables/overview.md +++ b/reference_versioned_docs/version-v4/environment-variables/overview.md @@ -15,10 +15,10 @@ If you are looking for information on how to configure your Harper installation ## Configuration -| Option | Type | Required | Description | -|--------|------|----------|-------------| -| `files` | `string \| string[]` | **Yes** | Path(s) or glob pattern(s) to the env file(s) to load. | -| `override` | `boolean` | No | If `true`, loaded values override existing environment variables. Defaults to `false`. | +| Option | Type | Required | Description | +| ---------- | -------------------- | -------- | -------------------------------------------------------------------------------------- | +| `files` | `string \| string[]` | **Yes** | Path(s) or glob pattern(s) to the env file(s) to load. | +| `override` | `boolean` | No | If `true`, loaded values override existing environment variables. Defaults to `false`. | ## Basic Usage