Skip to content

docs: add local setup instructions to README - #49

Merged
artemkovalyov merged 1 commit into
mainfrom
docs-readme-local-setup
Aug 28, 2026
Merged

docs: add local setup instructions to README#49
artemkovalyov merged 1 commit into
mainfrom
docs-readme-local-setup

Conversation

@artemkovalyov

Copy link
Copy Markdown
Contributor

Summary

  • Adds a Node.js local setup section alongside the existing Docker section
  • Includes an upfront one-liner guiding contributors on when to use each option
  • Keeps the Docker section intact

Test plan

  • README renders correctly on GitHub

Copilot AI lite review requested due to automatic review settings August 28, 2026 21:46

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds contributor-facing local (Node.js) setup instructions to the root README, alongside the existing Docker workflow, so developers can choose a faster local option or a containerized option.

Changes:

  • Adds a brief “Local vs Docker” recommendation at the top of the setup section.
  • Introduces a new Local section with Node.js + npm commands to run the docs dev server.
  • Reformats the Docker instructions into a fenced shell block and consolidates the localhost URL note.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread README.md
Comment thread README.md
Copilot AI review requested due to automatic review settings August 28, 2026 21:48

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

Suppressed comments (1)

README.md:20

  • The README says Node.js "24+", which suggests Node 25+ is supported. Since CI and the Docker image are pinned to major 24, recommending 24.x avoids encouraging a potentially incompatible major version.
Requires [Node.js](https://nodejs.org/) 24+ (same major version used in CI/Docker).

Add a Node.js quick-start alongside the existing Docker section,
with an upfront guide on when to use each.

Signed-off-by: Artem Kovalov <artem.kovalyov@gmail.com>
Copilot AI review requested due to automatic review settings August 28, 2026 21:50
@artemkovalyov
artemkovalyov force-pushed the docs-readme-local-setup branch from d7b818a to 82a2e42 Compare August 28, 2026 21:50
@artemkovalyov
artemkovalyov merged commit 10825c8 into main Aug 28, 2026
8 checks passed

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Suppressed comments (2)

README.md:20

  • The stated Node.js requirement (18+) doesn’t match the version used by this repo’s CI (Node 24 in .github/workflows/static.yml), which can confuse contributors when they hit version-specific issues. Consider documenting the CI/recommended version alongside the minimum supported version.
Requires [Node.js](https://nodejs.org/) 18+.

README.md:23

  • To keep local setup aligned with the repo’s package-lock and CI (which runs npm ci), prefer npm ci here for a reproducible install.
npm install

Comment thread README.md
npm run docs:dev
```

### Docker
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.

2 participants