Skip to content

onboarding documentation for Tiptap project#14

Open
RostyslavSpodar wants to merge 1 commit intokoldovsky:mainfrom
RostyslavSpodar:main
Open

onboarding documentation for Tiptap project#14
RostyslavSpodar wants to merge 1 commit intokoldovsky:mainfrom
RostyslavSpodar:main

Conversation

@RostyslavSpodar
Copy link
Copy Markdown

@RostyslavSpodar RostyslavSpodar commented Mar 23, 2026

Summary by CodeRabbit

  • Documentation
    • Added comprehensive onboarding guide covering the monorepo structure, package architecture, and framework adapters.
    • Includes key concepts (Nodes, Marks, Extensions), development workflows, contributor guidelines, and PR readiness checklist.
    • Provides extension creation steps and command references for developers.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 23, 2026

📝 Walkthrough

Walkthrough

A new README-ONBOARDING.md file has been added providing a comprehensive onboarding guide for the Tiptap monorepo. The document covers the project's architecture, development workflows, key concepts, directory structure, contributor guidance, and command reference to facilitate developer onboarding.

Changes

Cohort / File(s) Summary
Documentation
README-ONBOARDING.md
New onboarding guide covering Tiptap monorepo architecture, layered package structure, key concepts (Nodes, Marks, Extensions, command chains), development workflows, contributor guidance, and commands reference.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A guide through the forest, so clear and so bright,
Where hoppers can learn what feels perfectly right,
Through architecture and workflows and concepts profound,
A trail laid with wisdom—new paths to be found! 🌿

🚥 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 'onboarding documentation for Tiptap project' accurately summarizes the main change—a new comprehensive onboarding guide for the Tiptap monorepo.
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: 2

🧹 Nitpick comments (1)
README-ONBOARDING.md (1)

1-9: Remove generated analysis header from the onboarding document.

Lines 1-9 read like tool output, not repo documentation, and distract from onboarding content.

Suggested cleanup
-========================================
-
-Repository: ueberdosis/tiptap.
-Files analyzed: 1917.
-Estimated tokens: 1.6M.
-Agent: Claude Sonnet 4.6 (Github Copilot).
-
-========================================
-
 # Welcome to the Tiptap Monorepo 👋
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README-ONBOARDING.md` around lines 1 - 9, Delete the generated analysis
header block at the top of README-ONBOARDING.md (the lines that start with the
======= separator and the "Repository: ueberdosis/tiptap" / "Files analyzed" /
"Estimated tokens" / "Agent" lines) so the onboarding document begins with the
actual project content; ensure no other onboarding content is removed and the
file now starts with the intended introduction section.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README-ONBOARDING.md`:
- Line 38: The two fenced code blocks containing the ASCII art box snippet
(around the "┌─────────────────────────────────────────────────────────┐" block)
and the directory listing starting with "tiptap/" must include a language
identifier (e.g., text) after the opening triple backticks; update the opening
fences for those blocks to use ```text so the linter MD040 is satisfied and
rendering/tooling behavior improves.
- Line 6: Update the product name capitalization in the string "Agent: Claude
Sonnet 4.6 (Github Copilot)" by changing "Github" to "GitHub" so it reads
"Agent: Claude Sonnet 4.6 (GitHub Copilot)"; locate that exact string in
README-ONBOARDING.md and apply the capitalization fix.

---

Nitpick comments:
In `@README-ONBOARDING.md`:
- Around line 1-9: Delete the generated analysis header block at the top of
README-ONBOARDING.md (the lines that start with the ======= separator and the
"Repository: ueberdosis/tiptap" / "Files analyzed" / "Estimated tokens" /
"Agent" lines) so the onboarding document begins with the actual project
content; ensure no other onboarding content is removed and the file now starts
with the intended introduction section.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: a043fe29-3b12-4248-82de-7bb96afcc7dd

📥 Commits

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

📒 Files selected for processing (1)
  • README-ONBOARDING.md

Repository: ueberdosis/tiptap.
Files analyzed: 1917.
Estimated tokens: 1.6M.
Agent: Claude Sonnet 4.6 (Github Copilot).
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 | 🟡 Minor

Fix product name capitalization at Line 6.

Use GitHub (capital “H”) for consistency and correctness.

Suggested fix
-Agent: Claude Sonnet 4.6 (Github Copilot).
+Agent: Claude Sonnet 4.6 (GitHub Copilot).
📝 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
Agent: Claude Sonnet 4.6 (Github Copilot).
Agent: Claude Sonnet 4.6 (GitHub Copilot).
🧰 Tools
🪛 LanguageTool

[uncategorized] ~6-~6: The official name of this software platform is spelled with a capital “H”.
Context: ...tokens: 1.6M. Agent: Claude Sonnet 4.6 (Github Copilot). ============================...

(GITHUB)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README-ONBOARDING.md` at line 6, Update the product name capitalization in
the string "Agent: Claude Sonnet 4.6 (Github Copilot)" by changing "Github" to
"GitHub" so it reads "Agent: Claude Sonnet 4.6 (GitHub Copilot)"; locate that
exact string in README-ONBOARDING.md and apply the capitalization fix.


## High-Level Architecture

```
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 | 🟡 Minor

Add language identifiers to fenced code blocks (MD040).

Both code fences should declare a language (e.g., text) to satisfy linting and improve rendering/tooling behavior.

Suggested fix
-```
+```text
 ┌─────────────────────────────────────────────────────────┐
 ...
-```
+```

-```
+```text
 tiptap/
 ...
-```
+```

Also applies to: 87-87

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 38-38: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README-ONBOARDING.md` at line 38, The two fenced code blocks containing the
ASCII art box snippet (around the
"┌─────────────────────────────────────────────────────────┐" block) and the
directory listing starting with "tiptap/" must include a language identifier
(e.g., text) after the opening triple backticks; update the opening fences for
those blocks to use ```text so the linter MD040 is satisfied and
rendering/tooling behavior improves.

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