Fix wrong claims and style drift on the Celo landing page and Celopedia page

Open
#2,386 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
Half a day
Newbie friendliness
62/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
markdown
Domain
documentation

Research direction

Start with learn/celo.mdx and AGENTS.md sections 3, 4, 6 and 8, then check the facts against build/build-with-local-stablecoin.mdx:23 and docs.json:57. The issue lists each fix by line, but choosing the right card links and rewording the "Start Building" copy takes judgment. Done means each listed line is fixed, the AGENTS.md card-icon rule is added, and the Celopedia page's Resources and Related sections match the table format.

Written by the indexing model from the issue text.

Description

documentation

These problems turned up in a review of #2385. That PR didn't cause them, but it touched learn/celo.mdx, and the cards there are the first thing people see on the Celo landing page.

Factual errors

  • learn/celo.mdx:8-9: the "Start Building" card says "No coding experience required", but it links to /build/agents/celopedia, where the first step is installing an AI coding skill from a terminal.
  • learn/celo.mdx:37: the "Local Stablecoins" card says Mento has "25+ local digital currencies". build/build-with-local-stablecoin.mdx:23 says Mento issues 15 stablecoins, and so does the AGENTS.md section 7 table.
  • docs.json:57: the banner says the Agents on Open Rails hackathon "kicks off Oct 6". That date has passed.

AGENTS.md gaps

  • #2385 says it applies the no-rocket rule to card icons as well, but AGENTS.md:84 still bans the rocket only in banners. One line in section 6 would cover cards.

Style (AGENTS.md sections 3, 4 and 8)

  • learn/celo.mdx:3: the description says "leading", has two sentences and ends with a period.
  • learn/celo.mdx: three cards point to Celopedia. "Start Building" (line 8) and "Quickstart" (line 91) link to /build/agents/celopedia, while "Celopedia: Celo Skill" (line 26) links to https://celopedia.celo.org/. The Quickstart card's "under 5 minutes" has no source.
  • learn/celo.mdx: the headings at lines 14, 31, 48, 68 and 134 are in title case.
  • build/agents/celopedia.mdx:4: the description is promotional, names no task, and ends with a period.
  • build/agents/celopedia.mdx:63: ## Resources is a bullet list rather than the Resource | Link table, and the page has no closing ## Related section.
Dominant language
MDX
Stars
89
Forks
396
Avg merge
3d 5h
Merged PRs (30d)
17

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from celo-org/docs

All issues in celo-org/docs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.