Skip to content

Excalidraw onboarding doc added#25

Open
andr0306 wants to merge 1 commit intokoldovsky:mainfrom
andr0306:homework
Open

Excalidraw onboarding doc added#25
andr0306 wants to merge 1 commit intokoldovsky:mainfrom
andr0306:homework

Conversation

@andr0306
Copy link
Copy Markdown

@andr0306 andr0306 commented Mar 26, 2026

Summary by CodeRabbit

  • Documentation
    • Added comprehensive onboarding documentation covering project overview, feature descriptions, technology stack, local setup instructions, monorepo structure, development workflows, testing guidance, troubleshooting tips, and contribution guidelines with Quick Start commands.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 26, 2026

📝 Walkthrough

Walkthrough

Added a new onboarding documentation file for the Excalidraw project that provides setup instructions, project structure overview, development workflow guidance, environment configuration details, and contribution steps for developers.

Changes

Cohort / File(s) Summary
Onboarding Documentation
docs/excalidraw-onboarding.md
New comprehensive guide covering project overview, tech stack, local setup (Node/Yarn prerequisites, installation, build scripts), monorepo structure, development workflow with Yarn scripts for typechecking/tests/linting/formatting, environment configuration using tracked .env.* files, testing overview, troubleshooting tips, contribution steps (branching, checks, commits, PRs), and Quick Start summary with essential commands.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 A guide emerges, clear and bright,
For devs to setup and take flight!
With scripts and paths and steps so true,
Now everyone knows just what to do! 🐇✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Excalidraw onboarding doc added' directly and clearly describes the main change: addition of a new onboarding documentation file for the Excalidraw project.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
docs/excalidraw-onboarding.md (1)

226-229: Consider varying sentence structure for improved readability.

Four consecutive troubleshooting items begin with "If", which slightly affects readability. While this is acceptable for a bulleted list, varying the sentence structure could improve flow. As per static analysis hints, repetitive sentence beginnings can be reworded.

✍️ Optional rewording suggestion
 - If `yarn` is missing, enable it with Corepack and use Yarn 1.22.22.
-- If install fails, make sure your Node.js version is 18 or newer.
-- If the app starts but collaboration does not work, check the WebSocket server URL in the environment config.
-- If AI or other connected features fail locally, check the related `VITE_APP_*` variables.
+- When install fails, verify your Node.js version is 18 or newer.
+- For collaboration issues after the app starts, check the WebSocket server URL in the environment config.
+- Should AI or other connected features fail locally, verify the related `VITE_APP_*` variables.
 - If formatting or lint checks fail, run `yarn fix`.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/excalidraw-onboarding.md` around lines 226 - 229, Reword the four
troubleshooting bullets that all start with "If" to vary sentence openings and
improve flow: modify the lines beginning "If the app starts but collaboration
does not work," "If AI or other connected features fail locally," "If formatting
or lint checks fail," and "If TypeScript errors look unrelated to your change"
so each uses a different lead (e.g., "Check the WebSocket server URL..." ; "For
AI or connected feature failures, verify the related `VITE_APP_*` variables..."
; "Run `yarn fix` to resolve formatting or lint issues..." ; "When TypeScript
errors seem unrelated, perform a clean install and retry..."). Ensure meaning is
preserved and keep them as short bulleted lines.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/excalidraw-onboarding.md`:
- Line 257: Update the onboarding step that reads "Open a pull request against
`master`." to reference the repository's actual default branch by replacing
`master` with `main` (or phrase it as "the default branch (main)"). Locate the
exact sentence "Open a pull request against `master`." in the document and
change it to "Open a pull request against `main`." and scan the rest of the file
for any other `master` mentions to update for consistency.

---

Nitpick comments:
In `@docs/excalidraw-onboarding.md`:
- Around line 226-229: Reword the four troubleshooting bullets that all start
with "If" to vary sentence openings and improve flow: modify the lines beginning
"If the app starts but collaboration does not work," "If AI or other connected
features fail locally," "If formatting or lint checks fail," and "If TypeScript
errors look unrelated to your change" so each uses a different lead (e.g.,
"Check the WebSocket server URL..." ; "For AI or connected feature failures,
verify the related `VITE_APP_*` variables..." ; "Run `yarn fix` to resolve
formatting or lint issues..." ; "When TypeScript errors seem unrelated, perform
a clean install and retry..."). Ensure meaning is preserved and keep them as
short bulleted lines.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 550b6f7a-c4e1-4ae5-974a-66e134e220ec

📥 Commits

Reviewing files that changed from the base of the PR and between be47f1d and f669cf7.

📒 Files selected for processing (1)
  • docs/excalidraw-onboarding.md

Create a pull request:

1. Push your branch to GitHub.
2. Open a pull request against `master`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Incorrect target branch name.

The documentation instructs contributors to open PRs against master, but this PR itself targets the main branch. This inconsistency will mislead new contributors about which branch to target.

🔧 Proposed fix
 2. Open a pull request against `master`.
+2. Open a pull request against `main`.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
2. Open a pull request against `master`.
2. Open a pull request against `main`.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/excalidraw-onboarding.md` at line 257, Update the onboarding step that
reads "Open a pull request against `master`." to reference the repository's
actual default branch by replacing `master` with `main` (or phrase it as "the
default branch (main)"). Locate the exact sentence "Open a pull request against
`master`." in the document and change it to "Open a pull request against
`main`." and scan the rest of the file for any other `master` mentions to update
for consistency.

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