Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update EIP-7329: Fix major website issue #7554

Closed
wants to merge 2 commits into from
Closed

Conversation

Pandapip1
Copy link
Member

@Pandapip1 Pandapip1 commented Sep 1, 2023

As it currently stands, this is bad for the SEO of ERCs, and I oppose this EIP until this is fixed.

Also. You can't make 301 redirects using GitHub pages, and I will not support you using multiple anti-patterns as a workaround because of all the obvious reasons that all anti-patterns have, as well as less obvious ones like it tanks the SEO even lower.

Also. Some ERCs use relative links to EIPs, and vice versa. We should keep it that way, for SEO reasons, and because updating those might be a pain.

Finally - why do you want to split the website? I can understand the annoyance of having one repo have to share multiple different flows, but the website? Can't you just... click on the "Core" link? Is it really worth it to you to split the website, just so you can have a marginally easier time looking at new EIPs?

@github-actions github-actions bot added c-update Modifies an existing proposal s-review This EIP is in Review t-meta labels Sep 1, 2023
@eth-bot
Copy link
Collaborator

eth-bot commented Sep 1, 2023

File EIPS/eip-7329.md

Requires 1 more reviewers from @lightclient, @shemnon

@eth-bot eth-bot added the a-review Waiting on author to review label Sep 1, 2023
@timbeiko
Copy link
Contributor

timbeiko commented Sep 1, 2023

A few thoughts here:

First, I don't think SEO should be one of our major concerns, and especially not SEO optimization. ercs. would still be an ethereum.org subdomain, and if the content is high quality people will search for / link to it. SEO should take care of itself.

Second, I think there is value in having domain-specific websites. For example, something I'd like on eips.ethereum.org that doesn't make sense for ercs.ethereum.org is to be albe to filter by fork (e.g. click a Fork field in an EIP header to see all the EIPs included in that fork). Similarly, a Deployement sub-page for ERCs would be very neat, where it shows contract addresses of mainnet deployments for certain standards. If you extrapolate even further with things like rollup-specific EIPs (RIPs), you can imagine rips.ethereum.org having a section that shows which rollups support which RIP. You could do all of this on a single website, sure, but that URL probably shouldn't be eips., and IMO given the number of "domains" we'll have here will be small, having a handful of subdomains is fine. If it gets to be too much, we can probably just create specs.ethereum.org and have it link to eips., ercs., rips., EELS and the CL specs.

Third, re: this "Is it really worth it to you to split the website, just so you can have a marginally easier time looking at new EIPs?", I think we should be optimizing for the end users as much as we can (even if it means the "behind the scenes process is more complex"). In that case, then, yes, a "marginally easier time" is valuable. The EIPs website can slowly get optimized for what protocol contributors want, the ERCs one for what standards users want, etc.

@Pandapip1
Copy link
Member Author

Pandapip1 commented Sep 1, 2023

First, I don't think SEO should be one of our major concerns, and especially not SEO optimization. ercs. would still be an ethereum.org subdomain, and if the content is high quality people will search for / link to it. SEO should take care of itself.

SEO doesn't take care of itself. Also, you haven't addressed the fact that you'll have to use anti-patterns.

Quite frankly, nothing should have to "take care of itself." Why create potential problems when they can be completely avoided?

Second, I think there is value in having domain-specific websites. For example, something I'd like on eips.ethereum.org that doesn't make sense for ercs.ethereum.org is to be albe to filter by fork (e.g. click a Fork field in an EIP header to see all the EIPs included in that fork). Similarly, a Deployement sub-page for ERCs would be very neat, where it shows contract addresses of mainnet deployments for certain standards. If you extrapolate even further with things like rollup-specific EIPs (RIPs), you can imagine rips.ethereum.org having a section that shows which rollups support which RIP. You could do all of this on a single website, sure, but that URL probably shouldn't be eips., and IMO given the number of "domains" we'll have here will be small, having a handful of subdomains is fine. If it gets to be too much, we can probably just create specs.ethereum.org and have it link to eips., ercs., rips., EELS and the CL specs.

As you have said, "You could do all of this on a single website". How is this an argument against using a single website?

ERCs are first-class EIPs and always have been. Also, there are plenty of non-Core non-Category EIPs that fit better with the ERCs than the Core EIPs. Your motivation for saying that eips.ethereum.org isn't the correct website URL for ERCs also just doesn't make sense. It literally has been the correct URL for those ERCs, since the subdomain's creation.

You seem to be under the impression that the fact that two things have different topics and have seperate review guidelines means that they shouldn't share a domain. I think that, in this, you are mistaken. Most popular journal groups (and believe me, we are a journal transitioning to becoming a journal group at this point) do have seperate, per-topic journals (e.g. Nature has a lot). However, they all share one domain, with one search. Because that's how people work best.

Third, re: this "Is it really worth it to you to split the website, just so you can have a marginally easier time looking at new EIPs?", I think we should be optimizing for the end users as much as we can (even if it means the "behind the scenes process is more complex"). In that case, then, yes, a "marginally easier time" is valuable. The EIPs website can slowly get optimized for what protocol contributors want, the ERCs one for what standards users want, etc.

I think you misunderstand here. I'm saying that the average user won't find it easier. Only a few specific people will have to avoid one button press, and the rest of us have to deal with "oh shoot, was 12582 an EIP or an ERC?". One website that can let users find everything is better than two that can't.

I am open to Core-specific website changes. I think that's a great idea, and I would love Core dev feedback there! But I have yet to see an argument for having two websites from anybody.

@shemnon
Copy link
Contributor

shemnon commented Sep 1, 2023

I am open to Core-specific website changes. I think that's a great idea, and I would love Core dev feedback there! But I have yet to see an argument for having two websites from anybody.

As I mentioned on one of the EIPIP calls the main value of website separation is that protocol development and application development are fundamentally two different audiences. Merging these two concerns onto one website blurs that distinction in an unhealthy way. There were many other arguments made on the EIPIP calls but this I think is an argument that stands on it's own.

So since the explanation was spoken on a zoom call you would have heard the reason, but you would not have seen it (unless you turn close captioning on or read transcripts).

@Pandapip1
Copy link
Member Author

Pandapip1 commented Sep 2, 2023

As I mentioned on one of the EIPIP calls the main value of website separation is that protocol development and application development are fundamentally two different audiences. Merging these two concerns onto one website blurs that distinction in an unhealthy way. There were many other arguments made on the EIPIP calls but this I think is an argument that stands on it's own.

In what way is merging the two websites unhealthy? As someone that also does research in a seperate field (Biology, of all things!), I can attest to the fact that having a single website improves UX.

Think about it this way: there are a lot of Wikipedia-type projects. But when you go to get information on a subject, do you go to Wikipedia or do you go to the Wikimedia Projects page to find the domain-specific wiki?

@shemnon
Copy link
Contributor

shemnon commented Sep 2, 2023

Separate websites allows each topic group to gain distinct identity, which is one of the chief positive outcomes of this migration. That way they can serve divergent needs: specifying and updating a protocol vs best practices for on-chain apps, for example. Wallet best practices and DeFi primitives could similarly be substituted.

Consider a lookup of Ledger. If I want a definition (protocol) I get wiktionary https://en.wiktionary.org/wiki/ledger as a link (also, mind the case!), if I want an overview (on-chain app) I get wikipedia https://en.wikipedia.org/wiki/Ledger and if I want financial usages (DeFi) I get a more specialized entry from Investopedia - https://www.investopedia.com/terms/g/generalledger.asp

All three have three different web sites and three different communities. Whether it is at the domain level of the website or at the path element is really splitting hairs: they are different websites at the end of the day.

@Pandapip1
Copy link
Member Author

You make a fair enough point. I would be okay with Core EIPs getting their own website, as long as it's the ERCs and Interface EIPs that stay on eips.ethereum.org, and the Core EIPs that get split into a new domain. Your argument is still not enough to convince me changing the canonical URLs of any ERC-category or Interface-category EIPs.

@shemnon
Copy link
Contributor

shemnon commented Sep 5, 2023

ERCs are not called EIP ERCs, ERC-20 is just ERC-20, as is ERC-721, etc. etc. Outside of core protocol changes I've seen community members correct others saying "you mean ERC-4337, not EIP-4337."

So it would be contradictory to ask people to go to eip.ethereum.org to get info on ERC-20 and to pcr.ethereum.org to get EIP-4844 info.

@lightclient
Copy link
Member

We discussed on EIPIP 89 and decided to move forward with the website split.

@lightclient lightclient closed this Sep 6, 2023
@bumblefudge
Copy link
Contributor

I can try to help if the redirects per-moved-spec is hard to implement in Jekyll

@Pandapip1 Pandapip1 deleted the Pandapip1-patch-10 branch September 6, 2023 17:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
a-review Waiting on author to review c-update Modifies an existing proposal s-review This EIP is in Review t-meta
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants