Skip to content

Commit

Permalink
feat: create adding resource guide
Browse files Browse the repository at this point in the history
  • Loading branch information
wackerow committed Feb 28, 2025
1 parent 915065e commit 3a1ce17
Showing 1 changed file with 55 additions and 0 deletions.
55 changes: 55 additions & 0 deletions public/content/contributing/adding-resources/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: Adding Resources
description: The policy we use when adding resources to ethereum.org
lang: en
---

# Adding Resources {#adding-resources}

We want to make sure we list the best resources possible while keeping users safe and confident.

Anyone is free to suggest new resources to add to the resource dashboard on ethereum.org, currently found at [ethereum.org/resources](/resources/).

**Please only suggest new additions for this page.**

Although we welcome new additions, the current resources were chosen based on an experience we're trying to create for our users. These are based on some of our design principles:

- _Inspirational_: anything on ethereum.org should offer something new to users
- _A good story_: what's listed should provide an "aha" moment
- _Credible_: everything should be legitimate businesses/projects to minimize risk to users

Overall **ethereum.org aims to provide a seamless onboarding experience for new users**. For that reason, we add resources based on their:

- ease of use
- accuracy
- maintenance

## The decision framework {#decision-framework}

### Criteria {#criteria}

- **Honest and accurate listing information** - Any suggested listings must come with honest and accurate information. Products that falsify information will be removed.
- **Active project** – The resource should be maintained by an active team to ensure quality and support for users. Outdated resources are subject to removal.

### Product Ordering {#product-ordering}

We reserve the right to order products based on their impact. New products will generally be added to the bottom of the list unless otherwise specified.

## Maintenance {#maintenance}

As the Ethereum ecosystem evolves, we will routinely check our content to:

- Ensure that all resources listed still fulfill our criteria
- Verify there aren't products that have been suggested that meet more of our criteria than the ones currently listed

You can help with this by checking and letting us know. [Create an issue](https://github.com/ethereum/ethereum-org-website/issues/new?template=bug_report.yaml) or send an email to [website@ethereum.org](mailto:website@ethereum.org).

---

## Add your resource {#add-your-resource}

If you want to add a resource to ethereum.org and it meets the criteria, create an issue on GitHub.

<ButtonLink href="https://github.com/ethereum/ethereum-org-website/issues/new?assignees=&labels=resource+📚&template=suggest_resource.yaml">
Create an issue
</ButtonLink>

0 comments on commit 3a1ce17

Please sign in to comment.