Skip to content

docs: use "app" instead of "dApp" across the docs - #2322

Merged
GigaHierz merged 2 commits into
mainfrom
francesco-cianciulli/draft-sep-17
Sep 17, 2026
Merged

GigaHierz merged 2 commits into
mainfrom
francesco-cianciulli/draft-sep-17

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Replaces "dApp" with "app" across the docs, per the decision to retire the term.

This branch started as a Mintlify editor draft that made the change on build-on-celo/index.mdx only. That page is now corrected and the rest of the docs are swept to match, so the change lands as one terminology decision rather than one page out of 43.

Closes #2323

What changed

41 files, +91 −91. No page moves, no docs.json changes, no redirects — page titles change, URLs do not.

  1. The sweep. 95 occurrences across tooling/ (83), build-on-celo/ (16), home/ (6) and contribute-to-celo/ (3). operate/ had none. Lowercase app/apps in prose; title case only in a page title.
  2. Article agreement. a dAppan app, not a app. 14 lines, e.g. tooling/dev-environments/hardhat.mdx:25, tooling/indexers/the-graph.mdx:6.
  3. decentralized applications (dApps)apps, dropping the parenthetical. 6 lines, all in tooling/bridges/*.
  4. Corrections to the original draft on build-on-celo/index.mdx:
    • Dropped the og:description the editor injected. AGENTS.md §3 forbids it; pages carrying it are being migrated away (Refs #2239).
    • your first Appyour first app, some Apps havingsome apps having. The draft capitalized both mid-sentence; only the branded "Mini App" is capitalized (AGENTS.md §7).
    • Rewrote description:. It was A guide for building on Celo. — double space, trailing period, and it states no outcome, which matters because description is what llms.txt hands to AI assistants (AGENTS.md §3/§8).
  5. AGENTS.md §7 Names gains the rule, so the next contributor does not reintroduce the term.

Deliberately not changed

Product names, verified one by one rather than regexed over:

Kept Where Why
dAppLooker, dapplooker.com tooling/explorers/analytics.mdx product name, including the ## dAppLooker heading
Dapp Radar, dappradar.com build-on-celo/launch-checklist.mdx:54 product name — the trailing label "General dApp directory" did change
@celo/dappkit, Dappkit, and the slug base-cli-contractkit-dappkit-utils contribute-to-celo/release-process/ package name; leaving the slug alone is why this PR needs no redirects
DApp User tooling/dev-environments/multibaas/overview.mdx:35,40 a MultiBaas API key type — renaming it would misname a partner's product

submodules/developer-tooling is a separate repo and is untouched.

Judgement calls

Both are reversible one-liners, flagged rather than smuggled in:

  • home/protocol/governance/governance-toolkit.mdx:12**StakedCelo dApp****StakedCelo app**. Read as a descriptive link label, not the product's registered name. Say the word and it goes back.
  • home/wallets.mdx:64 — "Discover popular Dapps for your needs" is partner blurb text; lowercased to apps for consistency with the rest of the page.

What this does NOT do

Several tooling/oracles/* and tooling/libraries-sdks/* pages are near-duplicate partner boilerplate that reads poorly for reasons unrelated to this term — five ContractKit pages carry a byte-identical migration sentence. This PR changes the term and nothing else; the rewrite is separate work.

It also adds no CI gate. A grep lint would have to encode the product-name allowlist above, which is probably not worth it for a one-time sweep — the AGENTS.md rule is the guard. Noted as an open question on #2323.

Verification

Run on the branch head (979d8f05):

$ grep -rn "dApp\|dapp\|DApp\|Dapp" --include="*.mdx" home tooling contribute-to-celo operate build-on-celo
tooling/libraries-sdks/contractkit/index.mdx:25:[ContractKit](/contribute-to-celo/release-process/base-cli-contractkit-dappkit-utils) supports the following functionality:
tooling/explorers/analytics.mdx:26:## dAppLooker
tooling/explorers/analytics.mdx:28:dAppLooker provides comprehensive analytics and visualization tools for decentralized applications.
tooling/explorers/analytics.mdx:30:See [dAppLooker docs](https://docs.dapplooker.com/) for more info.
tooling/explorers/analytics.mdx:31:You can explore Celo-specific analytics on dAppLooker <ColoredText>[here](https://dapplooker.com/analytics/celo)</ColoredText>.
contribute-to-celo/release-process/index.mdx:13:- [CeloCLI and ContractKit](/contribute-to-celo/release-process/base-cli-contractkit-dappkit-utils)
tooling/dev-environments/multibaas/overview.mdx:35:MultiBaas has multiple key types with different permission levels. The most frequently used are Administrator and DApp User:
tooling/dev-environments/multibaas/overview.mdx:40:| **DApp User** | Safe to use in frontend apps, read-only and unsigned transaction composition |
contribute-to-celo/release-process/base-cli-contractkit-dappkit-utils.mdx:86:- @celo/mobile - Dappkit relies on this
build-on-celo/launch-checklist.mdx:54:- [ ] [Dapp Radar](https://dappradar.com) - General app directory

Every survivor is on the allowlist above.

$ grep -rniE "\ba app\b|\ba apps\b|\ban apps\b" --include="*.mdx" home tooling contribute-to-celo operate build-on-celo
(no output)

$ grep -n "og:description" build-on-celo/index.mdx
(no output)

$ mint broken-links
⠋ checking for broken links...
success no broken links found

No code examples were added or changed, so there is nothing to execute.

Mintlify

0 threads from 0 users in Mintlify

  • No unresolved comments

Review in Mintlify

- Updated build-on-celo/index.mdx

Mintlify-Source: dashboard-editor
Replace the retired term across 40 content pages, drop the og:description
the editor added to the Build on Celo landing page, and pin the naming
rule in AGENTS.md section 7 so it does not drift back.

Product names keep their own spelling: dAppLooker, DappRadar, @celo/dappkit,
and the MultiBaas "DApp User" key type. No page moves, no redirects.

Closes #2323

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
@GigaHierz
GigaHierz requested review from a team as code owners September 17, 2026 10:08
@GigaHierz
GigaHierz requested review from karlb and seolaoh and removed request for a team September 17, 2026 10:08
@GigaHierz GigaHierz changed the title Draft from Sep 17 docs: use "app" instead of "dApp" across the docs Sep 17, 2026
@GigaHierz
GigaHierz merged commit baee7d7 into main Sep 17, 2026
5 checks passed
@GigaHierz
GigaHierz deleted the francesco-cianciulli/draft-sep-17 branch September 17, 2026 10:12
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.

task: replace "dApp" with "app" across the docs and pin the naming rule in AGENTS.md

1 participant