Giter Site home page Giter Site logo

ethereum / ethereum-org-website Goto Github PK

View Code? Open in Web Editor NEW
4.8K 203.0 4.6K 601.27 MB

Ethereum.org is a primary online resource for the Ethereum community.

Home Page: https://ethereum.org/

License: MIT License

JavaScript 0.01% Solidity 0.01% Markdown 95.72% TypeScript 4.25% Shell 0.01% CSS 0.01% HTML 0.01%
ethereum blockchain react web3 chakra-ui typescript nextjs

ethereum-org-website's Issues

"Built on Ethereum" link broken

The "Built on Ethereum" link is broken. Looks like it's being treated as a relative path when it should be an absolute link..

The link can be found on this page, just before the part (2)

Fix promotion issue

I know that Ethereum as an organization provides poor promotion to its' members and it should be fixed. But it doesn't mean that members of the team should take advantage of their position and put advertisement into the community/project resources wherever they want.

I've already reported this problem with "New artwork" plate and I've just found an artwork authors' links in the site footer. Footer links are very high ranking by search engines and it's strange to see this long list of coauthors right there. Who are all of this people? What have they done for Ethereum, except of this glance picture like hundreds of others around the Web? Where Gavin Wood's link, Richard Moore's, or Ethereumjs' team members? For me It looks like nepotism and I strongly dislike that.

Screen Shot 2019-08-25 at 13 47 38

Members promotion processes should be transparent, publicly audited and more inclusive. Now it's completely opposite. It should be solved with the next steps:

  • Provide schedule for renewing artworks: monthly, weakly, daily. This term shouldn't be longer than a month.
  • Create a queue of artworks (It could be separated repo with issues as a queue).
  • Call other designer to participate via Ethereum's twitter account and site notification.
  • Give artwork authors ability to provide a link to their portfolio and one or two paragraphs of text to say something.
  • Create a blog where the team members could write articles about their work.
  • Add blog entries' titles into the main page.
  • Create lists of current and ex-members of the team.
  • Create artworks site section where all artworks could be seen.

Replace "Build" with "Developers"

This issue is based off a conversation with Scott Lewis on twitter, where he made the following point:

for a developer to realize the developer portal exists they must also know that ethereum nomenclature for a developer is a builder, but IRL a builder is someone who builds houses. given the devs visiting http://ethereum.org are new to ethereum, this is suboptimal.

My steel man to expand on this is:

  • ethereum.org - especially the landing page - should lean towards optimizing for people who are new to Ethereum. Someone who is already part of the community is less likely to rely on the landing page as an index of the site, because they will already know to go to ethereum.org/build for technical resources
  • "Build" is Ethereum-community specific language that could be confusing to a developer who is looking for a "Docs" or "Developer" subpage. The websites for Rust, React, Python, Firebase, and Ember.js do not use "Build" as a top level category.

What do others think? cc @maurelian

Warrant canary

Ethereum.org doesn't have a warrent canary in the footer anymore. The foundation page https://ethereum.foundation/ has one. Is that enough or should ethereum.org also have one?
If it's wanted I could create this pull request.

Ethereum is a product

This line should be removed from the guidelines:
"Ethereum.org should not be a traditional product website like every other blockchain. There is no sales pitch."

Ethereum is as much a product as any other blockchain or open source project, see apache.org, linux.org, python.org, angular.io, etc... for preexisting projects which have.

Rejecting everything currently known about the utility of websites and branding and pretending ethereum is immune to the need makes little sense.

There are people right now who would love to pitch ethereum as a technology to their company and can't, because the website looks so bad, and they'd never be able to sell it to their boss.

I've had C level executives reach out to me about this, it's not minor.

Ethereum.org not forcing https

If my assumption that Ethereum.org utilizes aws cloudfront, enforcing https (aka redirecting all http traffic to https) is as simple as checking a checkbox in AWS:

To configure CloudFront to require HTTPS between viewers and CloudFront

  1. Sign in to the AWS Management Console and open the CloudFront console at https://console.aws.amazon.com/cloudfront/.

  2. In the top pane of the CloudFront console, choose the ID for the distribution that you want to update.

  3. On the Behaviors tab, choose the cache behavior that you want to update, and then choose Edit.

  4. Specify the following values for Viewer Protocol Policy: Redirect HTTP to HTTPS

Reference: https://twitter.com/_prestwich/status/1161420491652866049?s=19

broken link

On this page:

  • clicking on Ethereum Developer Tools List #Patterns—best-practices redirects to 404.

  • clicking on Geth under Clients & Running your own node section redirects to 404.

Separate out the vuepress theme

It would be great if the Vuepress theme is separate out from the project. It'll be easy to maintain code and content another advantage is that the theme can be used or maintained by any other Vuepress developer. Let me know if you agree I'm happy to submit a PR.

Ideas for new sub-pages

Ethereum is more than just a technical blockchain. It's humanistic values and collaborative community what makes it thrive and special. Here are some ideas for sub-pages:

🌍🌏🌎- A page on social impact: Examples on how ethereum is helping disadvantaged societies, working on charitable activities, and how it is good for the planet. (highlighting Giveth and other similar organizations)

🎨🌟🌈- A page for Artists: expressing their views, perceptions and visions about ethereum & it's community. Ethereum is bringing us new ideas on its possibilities and we tend to have a challenge to understand how to define it. why not open the door to artists to contribute in providing us new perceptions.

🎓🏫📚- A page to list the research topics for ethereum by Universities and Organizations. This page is dedicated to show how ethereum studies can expand the intellectual horizon of the world. (i.e. inventing new economic models, new mathematical models, social studies, etc.) which gives back to the society.

Change “Fork this page” / GitHub icon

The “fork this page” is confusing to many.

On mobile, the GitHub icon is always present, and just links to the GitHub for the website without any context.

Suggestion: change wording to “Get Involved” and make a Get Involved page that has links to the GitHub and explains how the website is managed.

Thinking about this more, having this on every page is overkill. Maybe in the footer - “See an error, have a suggestion, or want to make an improvement to this page or site? Get involved”

On mobile, probably remove the icon altogether and people can navigate to the “Get Involved” page via the menu.

Sidebar isn't scrollable

Sidebar has no scrollbars though its' elements became unreachable when page height is too small.

Browser: Chrome 76.0.3809.100
OS: MacOS 10.14.6

Screen Shot 2019-08-22 at 01 29 10

Images to break up the text on etherem.org/beginners

Right now the Beginners page is very sparse and text-heavy. This page is targeted at people who are entirely new to Ethereum, but it's an intimidating wall of text.

One way to improve this would be to add images to break up sections of text. Examples that could be useful:

  • Photos from Ethereum events showing our large community
  • Images that show or represent the Ethereum network (e.g. distribution of nodes around the world?)
  • Graphics or infographics displaying information about Ethereum
  • Simple graphical explanations of concepts in this text (e.g. "decentralized")
  • Live graphical "widgets" showing network statistics?

Add Guarda Wallet to the USE section

Guarda is a custody-free multi-platform wallet with Ethereum (and Ethereum-based tokens) support. The user-friendly wallet interface is perfect for a cryptocurrency novice + Guarda Wallet blog always has useful information on managing various supported cryptocurrencies (step-by-step guides, videos and detailed descriptions).

[Proposal] TCR for dapps listing

Abstract / TL;DR

Current dapps listing is curated by a small set of validators, use a dynamic TCR (Token Curated Registry) with Kleros to highlight projects and keep the listing curated.

Proposal

As currently stated in Use Section, Dapps highlighted are frequently updated. this proposal is a pathway to have something as suggested in #63.

Kleros is a dispute resolution platform currently specialized in TCR maintenance and curation.

Anybody can submit a proposal with their AragonDAO Gouvernance to create a "Court" with specific guidelines,

These guidelines would state what is a acceptable project to be listed on the website, guidelines can be crafted by the current small set of website validators.

Project willing to be listed on the website TCR would submit their application to the TCR with a small deposit, if the project isn't compliant with the guidelines anybody can challenge it and Kleros jurors will arbitrage the dispute, the winning party earn the deposit of the opposing party.

Implementation

When the TCR have enough "curated" project listed according to validators, the website parse the TCR and randomly select a subset of projects to highlight.

Additional Comments

  • If implemented this process can be detailed as an exemple in Learn Section of what is a TCR
  • This process can be used to highlight ecosystem tokens but my personal stance on this is that promoting any kind of financial investment should be outside the scope of this website.
  • Disclamer : I am not part of Kleros Team outside of building an open-source third-party app on the Kleros Protocol but i own some PNK tokens linked to the project.

Useful links

Upgrade notification plate

There is a plate "Read about the new artwork!" which is showing on each page of the site. Is it so important for Ethereum community to be placed here? I don't think so. This information could be shown on the main page under the artwork. It would be enough. I think such things could be used for noticing about hardforks, security issues, and important events.

It looks more like advertisement popup than important information notice. There should be a blog section and a block on the main page for things like this.

In my opinion it's unfriendly self-promotion of some team members in it's current view.

Alternatives to current headline

Current: "Ethereum is a global, decentralized platform for money and new kinds of applications. On Ethereum, you can write code that controls money, and build applications accessible anywhere in the world."

Problems with current:

  • Fails to mention what's different about these applications compared to web apps
  • Over-emphasizes money

Alternative proposals

  • Ethereum is a global, decentralized platform for building applications that are secure, can operate without a central administrator and are highly robust against third-party interference.
  • Ethereum is an open-source, decentralized platform for building applications that run exactly as programmed and are highly resilient against faults and third-party interference.
  • Ethereum is a global open-source platform for building decentralized applications and economic mechanisms. Applications on Ethereum are executed in a massively replicated public ledger that allows anyone to verify that computations are being executed correctly, and ensures a high level of fault tolerance and robustness.
  • Ethereum is a permissionless open-source platform for building decentralized applications and economic mechanisms. Applications on Ethereum are executed in a massively replicated public ledger that guarantees that code is being executed exactly as written, without relying on a central administrator to remain online or honest, and can be accessed from anywhere in the world.
  • Ethereum is a global, decentralized platform specially designed for building applications that need strong guarantees of liveness and protection against tampering or interference. Once an application on Ethereum is launched, it will continue running without requiring any central administrator, and the application can be accessed or verified from anywhere in the world.
  • Ethereum is an open-source, public blockchain-based platform for running distributed applications that demand high guarantees of security and robustness against tampering or faults. On Ethereum you can build applications that handle digital assets, implement economic mechanisms and markets, and timestamp and create tamper-proof logs of critical data, along with many other use cases being developed each month.

Not meant to be the end-all, just some starting points. IMO if we want to mention money, we need to mention at least one thing that is not money too; and for a two-sentence intro that may not be appropriate.

Some ideas above have been partially plagiarized from:

Car Changer

Car Changer Application Will Help People To Change Own Cars With each other Based on Smart Contract In Ethereum Block Chain.Each Person Must Have An Account In Car Changer App and Can Sign Own Cars With Some Mandatory Information Such As Year Of Product,Company Name,Color And ETC .According to Smart Contract Car Evaluated And Price Of It Announced To Owner.IF The Owner Apply The Price When A User That Send A Change Transaction, Smart Contract Will Check The Transaction And Price Of User Car. If Price OF User Car Is Less Than Another User, Transaction Will be Complete After Remain Value Of Car Spend To That User From ETH Wallet And They Have 3 Days Time To Deliver Cars To Each Other.IF After 3 Days Based On Members Verification Car Delivery Did not Accomplish, Another Transaction Automatically Returns ETH Wallet With Compensation To User That Member Announced.The Value Of Compensation Will Be Spend From User ETH Wallet That Members Verified.
Author:Mohammad Taghipour
For More Information:[email protected]

The landing page is poorly designed

The top links are randomly placed, and it is unclear what the site is about. Attached is a slightly less poorly designed version of the landing page.
site1

Little mention of Bitcoin

The old site had a section dedicated to describing the relationship between ETH and BTC. Many users coming to the new site will likely know of Bitcoin and may hold some too. They will want to know how ETH matches up to BTC and whether they are in direct competition. Personally I am of the opinion that they can both benefit from each other. Having a link/page to a blurb about potential synergies could send a positive message and reduce anxiety of any BTC holders trying to learn more.

Feel free to disagree about this being a good idea.

Add "Last updated" to the website

Prize Bounty

0.5 ETH

Challenge Description

Ethereum.org will be regularly updated with new content. We should add a "Last updated" copy to more clearly communicate to users that the site is always evolving.

  1. Add a "Site last updated: " to the footer (Footer.vue)

example:
Image 2019-10-27 at 8 53 58 PM

  1. Add a "Page last updated:" under the header of every page

example:
Image 2019-10-27 at 8 50 03 PM

This might be a useful option: https://vuepress.vuejs.org/plugin/official/plugin-last-updated.html

Submission Requirements

  • The timestamps must be dynamically auto-generated from the config
  • The additions must consider mobile & desktop layouts

Submission Deadline

The deadline for submissions is November 11, 2019.

Judging Criteria

The prize will be awarded to the first valid submission.

Winner Announcement Date

The submission will be reviewed by November 18. Winner announcements and prize payouts will occur before November 31, 2019.

Link directly to wallets, not lists of wallets

Currently it takes a huge number of clicks to actually get to a wallet:

  • Click "use"
  • Click or scroll down to "what is a wallet"
  • Decide which of the four linked guides to click on
  • Get lucky and click on "get started with Metamask"
  • Or click on the ethhub link
  • Click on "desktop wallets"
  • Click on MyCrypto, get taken to a github page for some reason
  • Go back and click to the link that says where MyCrypto is downloadable

IMO this is a huge usability hurdle, we're basically requiring users to go down a pretty complicated educational rabbit hole before they can just get a wallet and have an ethereum address.

I would favor replacing this approach with a more opinionated one: we just link to the pages (ideally a tutorial link and a download link each) for some wallets that we select, (eg. Metamask, MyCrypto, the Opera browser, TrustWallet, a few more) that we deem to be high quality enough to expose new users to.

Also, I would favor switching around the order: step 1 should be getting a wallet, step 2 getting some ETH, step 3 using applications. This makes more sense because it's the only logical order in which you can do things: you need a wallet to get ETH, and you need a wallet and ETH to use applications.

Website should be compatible with Dark Mode extensions

Some people use extensions like Dark Reader when browsing the web. Currently, ethereum.org produces weird graphical errors when viewed through that extension, as documented here.

We should make ethereum.org compatible with such extensions, by either detecting them and flipping the website automatically to the existing dark-mode setting, or simply fixing the issues that cause the strange formatting issues.

Improve Beginners page content for people new to blockchain

It would be great if the Beginners section had a quick basic explanation of what blockchain tech is and how the introduction of smart contracts changed the space, plus a basic explanation of how smart contracts work. Alternatively there could be links to some high quality resources here that give a good basic understanding of these concepts.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.