Hey Ethereum community! We last spoke August 5 – how you been? We’re here to talk about something fresh we’ve shipped.
Maybe you’ve already noticed, but we’ve got a new Developers section. For a long time, this content was a wall of links to products you might find helpful when building a dapp. We provided very little context and left a lot of connecting the dots up to you. We thought we could do better.
Technical information about Ethereum is often fragmented, which can be a barrier for new developers who are trying to get their bearings.
Getting to grips with Ethereum development can feel like running uphill against a tide of outdated Stack Exchange threads and Medium articles. Or like having to wade through murky depths as you scour crypto Twitter for something useful.
So we set out to create an updatable repository for developer content that helps you:
- Learn about Ethereum under the hood
- Experiment with code
- Understand the tech stack of dapps
And perhaps more importantly, we wanted it to be a place for community collaboration. Anyone can submit PRs to improve and maintain the content. We’ve already seen a fantastic willingness from the community to dive in and help us improve the docs which is awesome.
In other words, we wanted to create MDN for Ethereum. And use our pool of fantastic translators to help educate on a global scale.
We on the ethereum.org team don’t have all the answers but as a community we’re amazing at sharing wisdom. Now, you’ve got the place to do it.
How you can get involved
Like ethereum.org in general, the portal is open source and there are ways to help whether you’re technical or not.
- Share your wisdom: we need experts to contribute information, code examples and more.
- Submit tutorials: if you’ve written a tutorial to help Ethereum devs, add it to ethereum.org to extend its reach
- Review content and PRs: expert on a topic? Help us make sure our content is as accurate as possible.
- Provide feedback: any feedback on your experiences are really helpful for our team. Hit us up on Twitter or Discord.
- Send us your ideas: everyone can help us design the best learning experiences possible.
- Send to your friends: Got aspiring dev friends? Send ethereum.org/en/developers their way.
Contributors get credited wherever possible.
Right, time for a quick tour…
So what’s new?
Ethereum documentation that gives you the background you need to understand how Ethereum works and how to build on the web3 stack.
You can now access community tutorials and write tutorials for ethereum.org to reach an enormous audience – we’ll be translating them to increase their reach.
There are links to dapp development frameworks and other developer tools to help you get from an idea to a deployed dApp. And to support the fantastic community efforts out there.
This project is very much in the MVP phase. We wanted to get a base level of documentation out the door as a priority. In the near term we’ll be working on a series of improvements that:
- better categorise the projects we list and add more filtering options, to help make choosing the right tool easier.
- create more guided learning experiences, specifically for absolute beginners.
- enrich the docs with helpful diagrams and videos (Know of any that would be great on one of our pages? Open a PR!).
- get more contributors to help make the docs as helpful as possible.
A lot of these ideas came from usability tests we ran with some amazing members and potential members of the Ethereum community – huge thanks to them!.
In the long term, we want to include more features that show (as well as tell), inject more web3 into the portal itself, and develop incentives/rewards for contributors. If you have any ideas – we’d love your input.
Help needed right away
If you’ve got a way with words and you know your way around the Ethereum stack or the EVM, here’s a few open content issues you could help out with:
- “Development network” page
- “Indexing and querying” page
- “Compiling smart contracts” page
- “Running your own node” page
- “Smart contract upgradeability” page
- “Deploying smart contracts” page
- “Testing smart contracts” page
- “Nodes as a service” page
- “Consensus mechanisms” page
Although it’s still early days, we wouldn’t have got this far without some folks who have provided their insight and feedback along the way. A big thanks to these fine people who have helped us ship this portal in some way or another:
Andrei Tonkikh, Artur Gontijo, Togzhan Barakbayeva, Felipe Farragi, Adrian Li, Paul Berg, Christian Reitwiessner, Franziska Heintel, Ryan Ghods, Hudson Jameson, Austin Griffiths, Jordan Lesich, Charles St Louis, David Murdoch, Kevin Bluer, Brian Gu, Marc Garreau, Markus Waas, Rob Stupay, Yann Levreau, Scott Bigelow, Santiago Palladino, Sina Goodfiotit, Charles St. Louis, Griffin Hotchkiss, Mario Havel, Edson Allyon, Franco Zeoli, Pato Palladino, Albert Ni, and Eric Shepherd