Skip to content

docs: apply the Variable Lab README structure, and move the repo docs to docs/ in lowercase - #48

Merged
rqbazan merged 7 commits into
mainfrom
docs/readme-structure
Oct 18, 2026
Merged

rqbazan merged 7 commits into
mainfrom
docs/readme-structure

Conversation

@rqbazan

@rqbazan rqbazan commented Oct 18, 2026

Copy link
Copy Markdown
Member

Applies the README structure from the vlab-brand skill's readme.md (brand#15).

What's in it

  • README.md (the root of a monorepo that is one Project):
    • the badges are gone, and the h1 links to https://lab.variable.land/env;
    • one sentence on what the repository holds;
    • the install command, and links to the package README and the docs;
    • Repository is now a list;
    • ## Contributing;
    • the License without "© Variable Land", and the Signature.
  • package/README.md (a Project's package):
    • the h1 link, and ## Usage with an env.ts checked against package/src;
    • an Entry points table;
    • ## Documentation starts at the Getting started URL that www uses;
    • absolute links, the License line and the Signature.
  • package/package.json: repository.directory is package, so npm resolves paths from the package folder.
  • LICENSE: the holder is "rcrd ricardo@variable.land". An identical copy goes in package/LICENSE, because npm only puts the package folder's LICENSE in the tarball.
  • The repo docs:
    • docs/CONTRIBUTING.md and docs/DEVELOPMENT.md are now docs/contributing.md and docs/development.md, renamed with git mv;
    • they take the sections of the readme chapter, and their content is the same;
    • every reference is updated: CLAUDE.md, the README, docsite/README.md and docsite/content/docs/community.mdx.
  • Changeset: a patch for @variablelab/env.

Verified

  • mise run check passes.
  • npm pack --dry-run in package/ lists LICENSE and README.md.
  • git grep finds no uppercase doc name left.
  • On the branch, in light and dark: square corners, the h1 links, the Signature, and no table splits a name. GitHub shows the Contributing tab.

🤖 Generated with Claude Code

https://claude.ai/code/session_01XRCpaD5QTPJsEjnhikoV2S

rqbazan and others added 7 commits October 18, 2026 07:34
docs/CONTRIBUTING.md becomes docs/contributing.md and docs/DEVELOPMENT.md
becomes docs/development.md, with every link to them updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XRCpaD5QTPJsEjnhikoV2S
The holder line becomes "rcrd <ricardo@variable.land>", and package/ gets an
identical copy of the root LICENSE, since npm only packs the package folder's.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XRCpaD5QTPJsEjnhikoV2S
The root README links the package README and the docs, lists the folders,
and ends with Contributing, License and the Signature. The package README
gains Usage, an Entry points table and absolute links, and package.json
names its directory so npm resolves the repository.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XRCpaD5QTPJsEjnhikoV2S
contributing.md takes Issues, Pull requests, Changesets and Releases, with
preview releases under Pull requests. development.md takes Layout, Setup,
Tasks and CI, with the git hooks under CI. Claims now match mise.toml,
lefthook.yml and the workflows, and the examples are no longer counted.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XRCpaD5QTPJsEjnhikoV2S
The setup and commands left the README for docs/development.md, so the
line that sent agents to the README for them now names the guide.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XRCpaD5QTPJsEjnhikoV2S
The env:pack row named package/.local/variablelab-env.tgz in a sentence
cell, and GitHub split it at the hyphen at narrower widths. The row now
names the folder, and the full path stays in the rest of the guide.

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

changeset-bot Bot commented Oct 18, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 35cf847

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 07a7316 into main Oct 18, 2026
17 checks passed
@rqbazan
rqbazan deleted the docs/readme-structure branch October 18, 2026 13:16
@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