Skip to content

docs: split the long README into a short overview plus docs/ - #131

Merged
com55 merged 1 commit into
mainfrom
docs/readme-split
Nov 11, 2026
Merged

com55 merged 1 commit into
mainfrom
docs/readme-split

Conversation

@com55

@com55 com55 commented Nov 11, 2026

Copy link
Copy Markdown
Owner

Summary

The root README was 600 lines and hard to scan, including on npm and flows.nodered.org. This change keeps a short overview (about 120 lines) and moves the detailed sections into docs/.

  • Install now starts with the Node-RED Palette Manager, then npm install, then a short note on GitHub pre-release .tgz assets.
  • Quick start covers opening /ai-access, creating a token, and choosing MCP or a GET link.
  • The README docs table uses absolute https://github.com/com55/node-red-ai-access/blob/main/... links so they work outside the repo.
  • New files: docs/configuration.md, docs/oauth.md, docs/rest-api.md, docs/ai-quickstart.md, docs/dashboard.md, and docs/development.md.
  • docs/README.md is updated as the documentation index. Existing generated docs and docs/releasing.md are unchanged.

Docs-only; no code changes.

Test plan

  • Markdown link check: README repo links exist; relative links and anchors in docs/ resolve.
  • Completeness pass against the previous README (details moved, not dropped).
  • yarn type-check, yarn lint, yarn format:check, yarn check:mcp-tools, yarn check:errors, and yarn test (1371 tests) pass locally.

Move configuration, OAuth, REST/MCP, AI quickstart, dashboard, and
development details into docs/. Keep a short README with palette-first
install, a quick start, and a docs table. Use absolute GitHub URLs in
the README so links work on npm and flows.nodered.org.
@com55
com55 merged commit a390003 into main Nov 11, 2026
7 checks passed
@com55
com55 deleted the docs/readme-split branch November 11, 2026 09:32
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