Skip to content

docs: refine landing page — version badge format and mcpd logo - #293

Merged
peteski22 merged 3 commits into
mainfrom
fix/version-badge-format
Aug 14, 2026
Merged

docs: refine landing page — version badge format and mcpd logo#293
peteski22 merged 3 commits into
mainfrom
fix/version-badge-format

Conversation

@peteski22

Copy link
Copy Markdown
Contributor

Two landing-page refinements for the GitBook site.

Version badge

Before, the badge read Version: v0.1.0 (documents mcpd v0.5.0) — leading with the docs version and jammed between the # mcpd title and the tagline. It now:

  • leads with the product version: mcpd v0.5.0 (docs v0.1.0) (or docs vX when no mcpd release is resolved);
  • sits below the tagline, before the first divider, via an explicit <!-- version-badge --> marker in index.md, so the title and tagline stay together and the badge gets its own space.

The heading/fence-scanning injection is replaced with a straightforward marker replacement that fails loudly if the marker is ever removed.

Landing-page logo

Re-add the mcpd logo to the home page (![mcpd](assets/mcpd-logo.png) under the H1), matching sibling products on docs.mozilla.ai (encoderfile, llamafile) that show a product logo for visual identification. It was dropped in the migration because it relied on the old MkDocs custom CSS; as a plain PNG it needs no theming.

@coderabbitai

coderabbitai Bot commented Aug 14, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@peteski22, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 11 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: a93fad8b-25c9-491e-8d6c-3bfff3dce981

📥 Commits

Reviewing files that changed from the base of the PR and between 1d2eb71 and 8e44758.

📒 Files selected for processing (3)
  • docs/index.md
  • scripts/prepare_gitbook_site.py
  • scripts/test_prepare_gitbook_site.py

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.

The landing-page badge read 'Version: v0.1.0 (documents mcpd v0.5.0)' -- leading with the docs version and jammed between the title and tagline. It now renders 'mcpd v0.5.0 (docs v0.1.0)' (or 'docs vX' when no mcpd release is resolved) and sits below the tagline, before the first divider, via an explicit marker in index.md.

Replaces the heading-and-fence-scanning injection with a straightforward marker replacement, which also fails loudly if the marker is ever removed.
Sibling products on docs.mozilla.ai (encoderfile, llamafile) show their product logo on the home page for visual identification. Re-add the mcpd logo -- dropped in the migration because it depended on the old MkDocs custom CSS -- as a plain PNG image under the H1, which needs no theming. The SVG is also available if preferred.
@peteski22
peteski22 force-pushed the fix/version-badge-format branch from 1b18c31 to bb8015b Compare August 14, 2026 14:00
The logo PNG is 1660x1697 (near square), so GitBook scaled it to the column width and rendered it huge. Cap it at width 200 with an <img> tag, matching the README's sizing and llamafile's git-synced pattern.
@peteski22
peteski22 merged commit 6823346 into main Aug 14, 2026
5 checks passed
@peteski22
peteski22 deleted the fix/version-badge-format branch August 14, 2026 14:26
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