Skip to content

docs: fix the stale texts in the repo docs, the docsite and the package description - #61

Merged
rqbazan merged 5 commits into
mainfrom
docs/stale-texts
Oct 18, 2026
Merged

rqbazan merged 5 commits into
mainfrom
docs/stale-texts

Conversation

@rqbazan

@rqbazan rqbazan commented Oct 18, 2026

Copy link
Copy Markdown
Member

Summary

Text that the repo contradicted, fixed against the code:

CLAUDE.md                # no Turborepo (there is none); points to docs/development.md instead of repeating it
docsite/CLAUDE.md        # a Lighthouse regression fails the manual "Audit SEO" run, not the PR
docs/development.md      # the examples list lives only in examples/README.md; start isn't in every example;
                         # `mise tasks ls --all`; the docsite Build job on PRs (#51); mise.audit.* (#55)
docs/contributing.md     # ci/ branches; no config_roots step (the glob picks new examples up); link the task table
examples/README.md       # a list, not a table, with what each example shows, /zod where missing, and its ports;
                         # no "12 e2e suites" or "4 SPA / SSR"; check, not test:types; env:watch runs chokidar
docsite/README.md        # no `pnpm test:types`
docsite/content/docs/    # secret isn't redacted and needs 16 chars; port accepts 0; logLevel exists;
                         # Config is the output type; defaults are coerced; the Zod 4 message;
                         # __ENV_NAME__ and discovery use VITE_ENV, else mode; EnvScript takes runtimeEnv;
                         # /fs, not /node; no Discussions (they're off); no counts of entrypoints or adapters
package/package.json     # the tagline as the description, with a patch changeset

Evidence

  • Before: jq .scripts docsite/package.json has no test:types, and mise tasks ls -C examples/ssr-react-router has no test:types.
    After: the docs name check.
  • Before: the docs said secret is redacted, and that port is 1–65535.
    After: they match package/src/zod.ts, where secret is z.string().min(16) and port is min(0).max(65535). A scratch run against the built library prints Invalid value at "server.HOST": Invalid input: expected string, received undefined, now on the page.
  • mise run check, pnpm --filter docsite build and pnpm changeset status pass. A second agent checked every hunk against the code, the ports against each example's config, and that the docs links resolve.

Merge Danger

Door: two-way

Blast Radius: docs

The docsite redeploys with the new pages when this merges. The changeset publishes a patch of @variablelab/env with the next "chore: update versions". Only the npm description changes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01TzjvWWSt2KQNsVgAtswGTL

rqbazan and others added 5 commits October 18, 2026 12:56
… runs by hand

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TzjvWWSt2KQNsVgAtswGTL
…s and steps

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TzjvWWSt2KQNsVgAtswGTL
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TzjvWWSt2KQNsVgAtswGTL
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TzjvWWSt2KQNsVgAtswGTL
@changeset-bot

changeset-bot Bot commented Oct 18, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 47b011c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@variablelab/env Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@rqbazan
rqbazan merged commit d809514 into main Oct 18, 2026
23 checks passed
@rqbazan
rqbazan deleted the docs/stale-texts branch October 18, 2026 17:59
@vland-bot vland-bot Bot mentioned this pull request Oct 18, 2026
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