Skip to content

chore: Update docusaurus doc titles#452

Merged
softmarshmallow merged 1 commit intomainfrom
cursor/update-docusaurus-doc-titles-ef43
Nov 12, 2025
Merged

chore: Update docusaurus doc titles#452
softmarshmallow merged 1 commit intomainfrom
cursor/update-docusaurus-doc-titles-ef43

Conversation

@softmarshmallow
Copy link
Copy Markdown
Member

@softmarshmallow softmarshmallow commented Nov 12, 2025

Update Docusaurus titles in docs/wg documents to provide clear and consistent sidebar and page headings, replacing placeholder or verbose titles.


Open in Cursor Open in Web


Note

Adds/normalizes front‑matter title fields across docs/wg pages and shortens a few verbose titles for consistent sidebar/page headings.

  • Docs (Docusaurus front‑matter)
    • Add/normalize title in:
      • docs/wg/feat-2d/optimization.md, feat-fontgen/index.md, feat-hash-nch/index.md, feat-image-filters/index.md, feat-layout/index.md, feat-masks/index.md, feat-painting/fe-noise.md, feat-painting/stroke-rect.md, feat-paragraph/impl-emoji-placeholder.md, feat-paragraph/impl-font-fallback.md, feat-paragraph/impl-italic.md, feat-paragraph/impl-opsz-auto.md, feat-paragraph/index.md, feat-resources/index.md, feat-vector-network/index.md.
    • Simplify titles in:
      • feat-crdt/id.md → "CRDT Object ID Model"
      • feat-icu-uct/index.md → "Unicode Coverage Tracker (UCT)"

Written by Cursor Bugbot for commit 29c6c36. This will update automatically on new commits. Configure here.

Summary by CodeRabbit

  • Documentation
    • Added metadata titles to working group documentation pages for improved organization and discoverability.
    • Enhanced Paragraph Feature Roadmap with expanded categorization covering Core Modeling, Painting, Text Editor, Fallback Model, and implementation details.
    • Standardized documentation structure across feature guides with consistent metadata formatting.

Co-authored-by: universe <universe@grida.co>
@cursor
Copy link
Copy Markdown

cursor Bot commented Nov 12, 2025

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@codesandbox
Copy link
Copy Markdown

codesandbox Bot commented Nov 12, 2025

Review or Edit in CodeSandbox

Open the branch in Web EditorVS CodeInsiders

Open Preview

@vercel
Copy link
Copy Markdown

vercel Bot commented Nov 12, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
backgrounds Ready Ready Preview Comment Nov 12, 2025 9:18am
blog Ready Ready Preview Comment Nov 12, 2025 9:18am
docs Ready Ready Preview Comment Nov 12, 2025 9:18am
grida Ready Ready Preview Comment Nov 12, 2025 9:18am
viewer Ready Ready Preview Comment Nov 12, 2025 9:18am
2 Skipped Deployments
Project Deployment Preview Comments Updated (UTC)
code Ignored Ignored Nov 12, 2025 9:18am
legacy Ignored Ignored Nov 12, 2025 9:18am

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Nov 12, 2025

Walkthrough

Multiple documentation files in the docs/wg/ directory updated with YAML front matter containing title metadata. Two files had title text simplified by removing "Working Group Draft" suffix. The Paragraph Feature Roadmap file was significantly expanded with categorized sections and nested checklist items.

Changes

Cohort / File(s) Summary
YAML Front Matter Addition
docs/wg/feat-2d/optimization.md, docs/wg/feat-fontgen/index.md, docs/wg/feat-hash-nch/index.md, docs/wg/feat-image-filters/index.md, docs/wg/feat-layout/index.md, docs/wg/feat-masks/index.md, docs/wg/feat-painting/fe-noise.md, docs/wg/feat-painting/stroke-rect.md, docs/wg/feat-paragraph/impl-emoji-placeholder.md, docs/wg/feat-paragraph/impl-font-fallback.md, docs/wg/feat-paragraph/impl-italic.md, docs/wg/feat-paragraph/impl-opsz-auto.md, docs/wg/feat-resources/index.md, docs/wg/feat-vector-network/index.md
Added YAML front matter metadata blocks with descriptive titles to individual pages. No content changes beyond metadata enrichment.
Title Text Simplification
docs/wg/feat-crdt/id.md, docs/wg/feat-icu-uct/index.md
Updated YAML front matter titles by removing "Working Group Draft" suffix for brevity.
Content Expansion
docs/wg/feat-paragraph/index.md
Added YAML front matter and significantly expanded roadmap with categorized sections (Core/Modeling, Core/Painting, Text Editor, Fallback Model, ICU, Ecosystem, Editor, fonts packages, References, Impls) and multiple nested checklist items.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~8 minutes

  • The vast majority of changes are repetitive YAML front matter additions across 14 files
  • Two title simplifications are straightforward text updates
  • The Paragraph Feature Roadmap expansion (docs/wg/feat-paragraph/index.md) warrants a brief review to verify the categorization and checklist structure are semantically correct

Poem

🐰 Hopping through the docs with glee,
Metadata blooms on every tree!
Front matter frames each working draft,
While paragraphs expand their craft.
Organization, neat and bright—
Documentation done just right!

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check ✅ Passed The PR title accurately describes the main changeset: updating Docusaurus documentation titles across multiple docs/wg files via YAML front matter modifications.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch cursor/update-docusaurus-doc-titles-ef43

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: 0

🧹 Nitpick comments (1)
docs/wg/feat-crdt/id.md (1)

1-4: Title update improves clarity and sidebar navigation; minor heading alignment consideration.

The YAML front matter title has been streamlined from the verbose original to "CRDT Object ID Model," which provides a clearer label for Docusaurus sidebar navigation. The "working group draft" context is appropriately preserved in the description field rather than cluttering the title.

The only minor observation is that the YAML title ("CRDT Object ID Model") now differs slightly from the main H1 heading ("Grida ID Model (for CRDT)"). While this is common in Docusaurus workflows, you may want to consider whether the two should be more aligned for consistency. If unifying them is preferred, consider either:

  • Updating the H1 to match the YAML title for consistency, or
  • Keeping the current approach (which is also valid and common).
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1a7a541 and 29c6c36.

📒 Files selected for processing (17)
  • docs/wg/feat-2d/optimization.md (1 hunks)
  • docs/wg/feat-crdt/id.md (1 hunks)
  • docs/wg/feat-fontgen/index.md (1 hunks)
  • docs/wg/feat-hash-nch/index.md (1 hunks)
  • docs/wg/feat-icu-uct/index.md (1 hunks)
  • docs/wg/feat-image-filters/index.md (1 hunks)
  • docs/wg/feat-layout/index.md (1 hunks)
  • docs/wg/feat-masks/index.md (1 hunks)
  • docs/wg/feat-painting/fe-noise.md (1 hunks)
  • docs/wg/feat-painting/stroke-rect.md (1 hunks)
  • docs/wg/feat-paragraph/impl-emoji-placeholder.md (1 hunks)
  • docs/wg/feat-paragraph/impl-font-fallback.md (1 hunks)
  • docs/wg/feat-paragraph/impl-italic.md (1 hunks)
  • docs/wg/feat-paragraph/impl-opsz-auto.md (1 hunks)
  • docs/wg/feat-paragraph/index.md (1 hunks)
  • docs/wg/feat-resources/index.md (1 hunks)
  • docs/wg/feat-vector-network/index.md (1 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
docs/**

📄 CodeRabbit inference engine (AGENTS.md)

Author and maintain all documentation under the root docs directory; it is the source of truth

Files:

  • docs/wg/feat-paragraph/impl-font-fallback.md
  • docs/wg/feat-paragraph/impl-italic.md
  • docs/wg/feat-hash-nch/index.md
  • docs/wg/feat-painting/stroke-rect.md
  • docs/wg/feat-paragraph/index.md
  • docs/wg/feat-layout/index.md
  • docs/wg/feat-paragraph/impl-emoji-placeholder.md
  • docs/wg/feat-paragraph/impl-opsz-auto.md
  • docs/wg/feat-image-filters/index.md
  • docs/wg/feat-icu-uct/index.md
  • docs/wg/feat-2d/optimization.md
  • docs/wg/feat-painting/fe-noise.md
  • docs/wg/feat-vector-network/index.md
  • docs/wg/feat-resources/index.md
  • docs/wg/feat-fontgen/index.md
  • docs/wg/feat-crdt/id.md
  • docs/wg/feat-masks/index.md
🧠 Learnings (2)
📚 Learning: 2025-09-15T10:31:32.864Z
Learnt from: CR
Repo: gridaco/grida PR: 0
File: crates/grida-canvas-fonts/AGENTS.md:0-0
Timestamp: 2025-09-15T10:31:32.864Z
Learning: Applies to crates/grida-canvas-fonts/tests/italic_level1.rs : Place core font selection and italic detection tests in tests/italic_level1.rs

Applied to files:

  • docs/wg/feat-paragraph/impl-italic.md
📚 Learning: 2025-09-15T10:31:32.864Z
Learnt from: CR
Repo: gridaco/grida PR: 0
File: crates/grida-canvas-fonts/AGENTS.md:0-0
Timestamp: 2025-09-15T10:31:32.864Z
Learning: Applies to crates/grida-canvas-fonts/tests/italic_name_checking.rs : Put name-based italic detection tests in tests/italic_name_checking.rs

Applied to files:

  • docs/wg/feat-paragraph/impl-italic.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: cargo test
🔇 Additional comments (16)
docs/wg/feat-vector-network/index.md (1)

1-3: Docusaurus metadata title addition looks good.

The YAML front matter is properly formatted and provides a clear, descriptive title for the page. No content changes to the documentation body.

docs/wg/feat-layout/index.md (1)

1-3: Docusaurus metadata title addition is consistent and well-formatted.

Clear, descriptive title with feature ID. Metadata-only change; documentation body remains intact.

docs/wg/feat-hash-nch/index.md (1)

1-3: Docusaurus metadata title addition is well-formed.

Descriptive title with feature ID. Metadata-only change; documentation content is preserved.

docs/wg/feat-masks/index.md (1)

1-3: Docusaurus metadata title addition is consistent and proper.

Clear title with feature ID in parentheses. Metadata-only change; content body is unchanged.

docs/wg/feat-painting/fe-noise.md (1)

1-3: Docusaurus metadata title addition is well-formatted.

Descriptive title with feature ID. Metadata-only change; documentation content remains intact.

docs/wg/feat-2d/optimization.md (1)

1-3: Docusaurus metadata title addition is appropriate.

Clear, descriptive title. Metadata-only change; documentation content is preserved.

docs/wg/feat-resources/index.md (1)

1-3: Docusaurus metadata title addition is well-formed.

Descriptive title with feature ID. Metadata-only change; documentation content is unchanged.

docs/wg/feat-icu-uct/index.md (1)

2-2: Title simplification improves clarity.

Removing the "- Working Group Draft" suffix from the title streamlines the page heading while the description field still conveys the working group status. This aligns with the PR's objective to provide clear, consistent titles. Metadata-only change; documentation content is preserved.

docs/wg/feat-fontgen/index.md (1)

1-3: LGTM! Title metadata is clear and descriptive for sidebar navigation, following consistent naming conventions across the PR.

docs/wg/feat-painting/stroke-rect.md (1)

1-3: LGTM! Clear, descriptive title appropriate for documentation sidebar navigation.

docs/wg/feat-image-filters/index.md (1)

1-3: LGTM! Title is consistent with the established naming pattern and provides clear navigation context.

docs/wg/feat-paragraph/impl-emoji-placeholder.md (1)

1-3: LGTM! Title metadata appropriately identifies this as an emoji placeholder rendering implementation.

docs/wg/feat-paragraph/impl-opsz-auto.md (1)

1-3: LGTM! Title clearly identifies the optical size automation feature with consistent naming convention.

docs/wg/feat-paragraph/impl-italic.md (1)

1-3: LGTM! Title metadata is descriptive and appropriately reflects the documentation scope on italic and oblique strategies.

docs/wg/feat-paragraph/impl-font-fallback.md (1)

1-3: LGTM! Title clearly identifies the font fallback strategy documentation with consistent naming.

docs/wg/feat-paragraph/index.md (1)

1-5: LGTM! Title and roadmap structure provide clear organization for the Paragraph feature documentation. The categorized checklist format improves navigation and status tracking.

@softmarshmallow softmarshmallow changed the title Update docusaurus doc titles chore: Update docusaurus doc titles Nov 12, 2025
@softmarshmallow softmarshmallow merged commit 42743cb into main Nov 12, 2025
12 checks passed
@softmarshmallow softmarshmallow deleted the cursor/update-docusaurus-doc-titles-ef43 branch December 14, 2025 08:33
@coderabbitai coderabbitai Bot mentioned this pull request Apr 7, 2026
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