Skip to content

docs: refresh documentation after the migration - #2

Merged
mkotelnikov merged 2 commits into
mainfrom
docs/refresh
Oct 5, 2026
Merged

mkotelnikov merged 2 commits into
mainfrom
docs/refresh

Conversation

@mkotelnikov

Copy link
Copy Markdown
Contributor

Refreshes the documentation to match the current code.

  • Root README: an operating manual covering package layout, the dependency graph, a package table with npm links, requirements (Node 24, pnpm via corepack), the root scripts, design reasons, known surprises, and how releases work.
  • Package READMEs: all 17 now follow one structure: what, why, how to use, examples, internals, license. Every export and every example was checked against src.
    • Removed APIs that do not exist, e.g. runPickDirectory, loadFragment, resolver.resolve(), setWorkspace, DOCK_LAYOUT_STORAGE_KEY.
    • Added the missing .promise to command calls.
    • Failure modes are documented with the actual error messages.
  • New READMEs for platform.node, webapp.core, webapp.browser and workspace-vcs.core.
  • package.json description fixed where it was stale or wrong: platform.core, platform.browser, platform.node, inline.core, mime.core, render.core. No other fields changed.
  • Factual corrections only in backbone.core/src/_vendor/README.md and workspace-vcs.core/CONTEXT.md.

No code, config, lockfile or CHANGELOG changes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DAiZN6XrTAdQpNN3eXEz2U

mkotelnikov and others added 2 commits October 5, 2026 09:31
- Root README rewritten as an operating manual: package layout and
  dependency graph, package table with npm links, requirements (Node 24,
  pnpm via corepack), the root scripts, design reasons, known surprises,
  release process.
- Every package README rewritten to one structure (what, why, how to use,
  examples, internals, license), with every export and example checked
  against src. Removed APIs that do not exist (runPickDirectory,
  loadFragment, resolver.resolve(), setWorkspace, DOCK_LAYOUT_STORAGE_KEY,
  ...), added missing `.promise` on command calls, documented failure
  modes with their actual messages.
- New READMEs for platform.node, webapp.core, webapp.browser and
  workspace-vcs.core.
- package.json descriptions fixed where stale or wrong (platform.*,
  inline.core, mime.core, render.core).
- backbone.core src/_vendor/README.md and workspace-vcs.core CONTEXT.md:
  factual corrections only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DAiZN6XrTAdQpNN3eXEz2U
@mkotelnikov
mkotelnikov merged commit 794858c into main Oct 5, 2026
2 checks passed
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