Skip to content

docs: update taglines and meta descriptions with new boilerplate - #358

Merged
jplgarcia merged 1 commit into
mainfrom
docs/boilerplate-refresh
Nov 11, 2026
Merged

jplgarcia merged 1 commit into
mainfrom
docs/boilerplate-refresh

Conversation

@jplgarcia

Copy link
Copy Markdown
Member

Summary

Rolls out the new Cartesi boilerplate (Foundation mandate) on docs.cartesi.io: titles, taglines and meta descriptions.

  • Site tagline (docusaurus.config.js): Any code. Ethereum's security.

  • Meta / og descriptions: no page had a description frontmatter, so Docusaurus was using each page's first paragraph (old copy). Added an explicit description to the three entry pages:

    • get-started/index.mdx (the landing page, / redirects here)
    • cartesi-rollups_versioned_docs/version-2.0/index.md (Rollups v2.0 overview)
    • docs/new-to-cartesi/overview.md

    Value: Any code. Ethereum's security. Build appchain rollups with languages, libraries, and tools you know and love. (tagline + optional add-on; the full short form is ~470 chars, too long for a meta description)

  • Opening paragraphs of those pages rewritten with the boilerplate short form.

  • static/llms.txt and static/skill.md: intro sentence aligned with the short form, so AI agents get the same positioning.

  • src/components/Hello.js (unused) updated so the old tagline no longer shows up in the repo.

The long form (Knoss paragraph) was intentionally left out of the docs.

Not in scope

  • The default version link/redirect still points to Rollups 1.5 on purpose; switching v2.0 to default comes in a follow-up PR.
  • og:image is still img/socialLogo2023.png; can swap here if there's a new social image.

Test plan

  • docusaurus build passes (pre-existing broken-anchor warnings only, none in touched files)
  • Built HTML for /get-started/, /cartesi-rollups/2.0/ and /new-to-cartesi/overview/ has the new description and og:description

🤖 Generated with Claude Code

Replace the old positioning copy ("Application-specific rollups with a
Linux runtime", "suite of products and tools", "modular blockchain
framework") with the new Cartesi boilerplate across the site:

- site tagline in docusaurus.config.js: "Any code. Ethereum's security."
- explicit description frontmatter on get-started, rollups v2.0 overview
  and new-to-cartesi overview, so meta and og descriptions use the new
  tagline instead of the first paragraph
- opening paragraphs of those pages rewritten with the short form
- llms.txt and skill.md intro aligned with the short form

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
github-actions Bot added a commit that referenced this pull request Nov 10, 2026
@github-actions

github-actions Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

📖 Docs preview removed

The preview for this PR was taken down because the PR is now closed.

@jplgarcia
jplgarcia merged commit 52d40d6 into main Nov 11, 2026
1 check passed
@jplgarcia
jplgarcia deleted the docs/boilerplate-refresh branch November 11, 2026 15:21
github-actions Bot added a commit that referenced this pull request Nov 11, 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.

3 participants