Developer docs: add goal-based wayfinding on the hub and intro pages#18016
Merged
wackerow merged 1 commit intoApr 23, 2026
Merged
Conversation
Two small, additive changes to help developers self-route through the
docs based on what they're actually trying to build.
public/content/developers/docs/index.md
Adds a "Pick a starting point" section above the development
modules with four goal-based entry points (dapp, smart contract,
node/staking, reading the protocol in order). Also tightens the
second paragraph of the intro so the "how to edit this" note reads
as a note rather than a full sentence of the lead copy.
public/content/developers/docs/intro-to-ethereum/index.md
Adds a "Where to go next" section before Further reading, giving
the same three goal-based paths. Mirrors the hub page so readers
arriving at the end of the intro aren't dropped back into the
generic nav.
The linked target pages already exist; no new routes required.
All new headings follow the existing {#kebab-id} convention.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
franrob-projects
requested review from
minimalsm,
pettinarip and
wackerow
as code owners
✅ Deploy Preview for ethereumorg ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
franrob-projects
added a commit
to franrob-projects/portfolio
that referenced
this pull request
Apr 23, 2026
- src/pages/projects.tsx: ethereum/ethereum-org-website#18016 added to the top of CONTRIBUTIONS. - blog/2026-04-22-ethereum-org-wayfinding.md: new post explaining why the PR exists and how to structure a docs PR against a protocol repo so reviewers can say yes faster. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
wackerow
approved these changes
Apr 23, 2026
Member
wackerow
left a comment
wackerow
left a comment
There was a problem hiding this comment.
Looks good! Thanks for the addition @franrob-projects, pulling this in
Member
|
@all-contributors please add @franrob-projects for content |
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Two small, additive edits that help developers self-route through the docs based on what they are actually trying to build, rather than reading the modules top-to-bottom.
public/content/developers/docs/index.mdPick a starting pointabove the Development modules, with four goal-based entry points (dapp, smart contract, node / staking, reading the protocol in order).public/content/developers/docs/intro-to-ethereum/index.mdWhere to go nextdirectly beforeFurther reading, mirroring three of the paths from the hub page. Readers finishing the intro don't get dropped back into the generic module list.Motivation
The hub page currently opens with a generic intro and then three
<DeveloperDocsLinks>blocks. Readers who know what they're trying to build (dapp vs. smart contract vs. running a node) still have to guess which of the three lists starts them off in the right place. Adding a goal-based block above the modules fixes that without touching the existing module ordering.The mirrored block at the end of intro-to-ethereum gives readers an obvious next step based on the same goals, so they don't have to go back to the hub to re-orient.
Scope
{#kebab-case-id}convention fromdocs/header-ids.md.public/content/developers/docs/.Issue
Not tied to a specific issue. Happy to open one first if that is the preferred process for wayfinding-style additions.