Skip to content

docs: add features overview and getting started guide#63

Merged
rsbh merged 1 commit into
mainfrom
docs/getting-started-features
May 13, 2026
Merged

docs: add features overview and getting started guide#63
rsbh merged 1 commit into
mainfrom
docs/getting-started-features

Conversation

@rsbh
Copy link
Copy Markdown
Member

@rsbh rsbh commented May 13, 2026

Summary

  • features.mdx: Full feature overview covering content, API reference, navigation, themes, SEO/AI, developer experience. Includes config reference for chronicle.yaml, meta.json, frontmatter, and markdown URLs.
  • getting-started.mdx: Updated with project structure, chronicle.yaml setup, meta.json, API reference, production build, and Docker.

Test plan

  • bun run dev:examples:basic — both pages render
  • Sidebar shows Features and Getting Started with correct order
  • Links between pages work

🤖 Generated with Claude Code

- features.mdx: full feature overview, config reference, meta.json
  guide, markdown URLs, API reference page documentation
- getting-started.mdx: updated with project structure, chronicle.yaml,
  meta.json, API reference, Docker setup

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 13, 2026

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

Project Deployment Actions Updated (UTC)
chronicle Ready Ready Preview, Comment May 13, 2026 8:34am

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 13, 2026

Review Change Stack

📝 Walkthrough

Summary by CodeRabbit

  • Documentation
    • Added comprehensive features documentation outlining Chronicle's capabilities including content management (MDX support, versioning), API reference tools (OpenAPI parsing, playground), navigation features, theming options, SEO and AI integrations, and developer experience enhancements.
    • Updated Getting Started guide with expanded installation instructions, configuration examples, project structure walkthrough, and deployment options.

Walkthrough

This PR adds and updates documentation for the Chronicle example project. It introduces a new comprehensive Features page describing product capabilities, configuration, and UI behavior, and upgrades the Getting Started guide to provide complete setup instructions with examples covering prerequisites, installation, project structure, development workflow, deployment, and Docker support.

Changes

Documentation: Getting Started and Features Guide

Layer / File(s) Summary
Updated Getting Started guide
examples/basic/content/docs/getting-started.mdx
Frontmatter order changes from 2 to 1, making this the first documentation page. Content expands from minimal Node.js/pnpm setup to a full quick-start covering Bun/Node prerequisites, installation via bun add, project structure example, expanded chronicle.yaml with detailed sections, writing the first MDX page, adding sidebar metadata via meta.json, dev server setup, OpenAPI API reference configuration, production build/deploy commands, Docker usage with oven/bun, and navigation links.
New Features documentation page
examples/basic/content/docs/features.mdx
New comprehensive reference documenting Chronicle's main capabilities across Content (MDX, frontmatter, directory metadata, remark plugins, syntax highlighting, versioning), API Reference (OpenAPI parsing, read-only overview, playground dialog, auth switching, code snippets, response export), Navigation (sidebar, breadcrumbs, prev-next, search, folder sorting), Themes (default/paper, dark/light modes), SEO & AI (meta tags, sitemap/robots/llms, .md URLs, "Open in AI"), and Developer Experience (CLI, hot reload, monorepo, Docker, Zod config). Includes configuration examples for chronicle.yaml and meta.json with field schema, page frontmatter structure, Markdown URL endpoints (/{slug}.md and /apis/....md), and detailed API Reference page UI including overview contents, playground dialog flow, and conditional "View documentation" linking.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

  • raystack/chronicle#57: Implements the .md route handlers for /apis/ API-reference operations and "Open in AI" behavior that this documentation describes and references.

Suggested reviewers

  • rohanchkrabrty
  • rohilsurana
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'docs: add features overview and getting started guide' directly and clearly summarizes the main changes: adding two new documentation pages for features and getting started.
Description check ✅ Passed The description is directly related to the changeset, providing clear bullet points about the two documentation files being added (features.mdx and getting-started.mdx) with their respective contents and a test plan.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/getting-started-features

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

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@examples/basic/content/docs/features.mdx`:
- Line 51: Update the user-facing copy string "**Open in AI** — copy as
markdown, open in ChatGPT or Claude" to capitalize "Markdown" so it reads
"**Open in AI** — copy as Markdown, open in ChatGPT or Claude"; locate and edit
the exact text in the examples/basic/content/docs/features.mdx file (the shown
user-facing sentence) to ensure consistency with technical documentation
styling.

In `@examples/basic/content/docs/getting-started.mdx`:
- Around line 13-19: The docs currently only show Bun commands under the
"Installation" and run sections; add equivalent npm (or npx) and pnpm command
variants so Node.js 20+ users can follow the guide. Update the "Installation"
code block (Installation heading) to include `npm install `@raystack/chronicle``
and `pnpm add `@raystack/chronicle`` alongside the Bun command, and similarly add
`npx`/`npm`/`pnpm` alternatives for the subsequent run/start examples (the
examples near the Installation and the two other command blocks referenced)
ensuring each code block lists Bun, npm, and pnpm variants in the same order for
consistency.
🪄 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 33ad4e7b-c9bd-4fc2-8cc5-939f13efbfd7

📥 Commits

Reviewing files that changed from the base of the PR and between 7ab1885 and 8498951.

📒 Files selected for processing (2)
  • examples/basic/content/docs/features.mdx
  • examples/basic/content/docs/getting-started.mdx

- **robots.txt** — auto-generated
- **llms.txt** — AI-discoverable documentation index
- **`.md` URLs** — every page (docs and API) has a markdown URL for AI tools
- **Open in AI** — copy as markdown, open in ChatGPT or Claude
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 | ⚡ Quick win

Capitalize “Markdown” in user-facing copy.

At Line 51, use “Markdown” (proper noun) for consistency with technical documentation style.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~51-~51: Did you mean the formatting language “Markdown” (= proper noun)?
Context: ...for AI tools - Open in AI — copy as markdown, open in ChatGPT or Claude ## Develope...

(MARKDOWN_NNP)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@examples/basic/content/docs/features.mdx` at line 51, Update the user-facing
copy string "**Open in AI** — copy as markdown, open in ChatGPT or Claude" to
capitalize "Markdown" so it reads "**Open in AI** — copy as Markdown, open in
ChatGPT or Claude"; locate and edit the exact text in the
examples/basic/content/docs/features.mdx file (the shown user-facing sentence)
to ensure consistency with technical documentation styling.

Comment on lines +13 to 19
- [Bun](https://bun.sh) (recommended) or Node.js 20+

## Installation

```bash
npm install @raystack/chronicle
bun add @raystack/chronicle
```
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 | ⚡ Quick win

Node prerequisite is listed but Node command path is missing.

Line 13 says Node.js 20+ is supported, but setup/run commands only show Bun. Please add npm/npx (or pnpm) equivalents so Node users can complete the flow.

Also applies to: 85-87, 112-115

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@examples/basic/content/docs/getting-started.mdx` around lines 13 - 19, The
docs currently only show Bun commands under the "Installation" and run sections;
add equivalent npm (or npx) and pnpm command variants so Node.js 20+ users can
follow the guide. Update the "Installation" code block (Installation heading) to
include `npm install `@raystack/chronicle`` and `pnpm add `@raystack/chronicle``
alongside the Bun command, and similarly add `npx`/`npm`/`pnpm` alternatives for
the subsequent run/start examples (the examples near the Installation and the
two other command blocks referenced) ensuring each code block lists Bun, npm,
and pnpm variants in the same order for consistency.

Comment thread examples/basic/content/docs/features.mdx
Comment thread examples/basic/content/docs/getting-started.mdx
Comment thread examples/basic/content/docs/getting-started.mdx
@rsbh rsbh merged commit 1450e83 into main May 13, 2026
4 checks passed
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