Close down this wiki in favour of ethresearch/wiki

[bmann]

As far as I know, the contents of the Github Wiki here have been ported to https://github.com/ethresearch/en-ethereum-wiki by @virgil.

I've filed an issue in that space as well to track progress https://github.com/ethresearch/en-ethereum-wiki/issues/3

Should this wiki be archived? I think it should Here are my suggestions:

• [ ] Review / merge in any recent changes by grabbing git of this Github wiki and doing a PR on en-ethereum-wiki (I see there are some people like @jamesray1 still editing here)
• [ ] Set the status of this repo to "archived"
• [ ] Have a message in the README directing people to the other website and repo

[jamesray1]

Last time I checked the wikiJS site didn't seem to be better. Details in https://github.com/ethereum/wiki/issues/589.

[bmann]

That’s an opinion. As is the opinion that wikiJS is better ;) It looks that thread has been deadlocked for month.

For WikiJS, I like the mix of front end editing by everyone, path based permissions and accounts, a simple to maintain hosting system, plus the full power of GitHub issues and PRs as well. It’s good for beginners who won’t use GitHub, and works for people that are comfortable in GitHub too. There are good upgrades coming in the next version of WikiJS.

It will also allow people to run alternate front ends too — since it’s just a native git repo for all the content.

I think we all agree that a plain GitHub wiki isn’t great, and locks us into the GitHub platform and URLs, with no power over redirects and limited moderation tools.

I mean, it’s up to whomever is in control of this repo. It’s time to make some clear decisions, clear out stale content, and just move forward.

I’ll be “signaling” by putting my time into the WikiJS wiki.

[fulldecent]

I came here to improve the NatSpec documentation today. But it has been vandalized/removed from this wiki. And there is no canonical source. So...

[ChrisChinchilla]

Personally I don't really mind what goes where, but I'd really like to have an EF maintained set of docs that takes people through what they need to know in an easy to find and easy to follow manner, forwarding them to appropriate sources for project docs when necessary. I am happy to be involved making this happen, but need to know if that's what people want to happen.

[jamesray1]

@ChrisChinchilla, it seems to me like the EF isn't interested in dedicating enough resources to maintaining docs, but perhaps I am wrong.

@fulldecent, I see that you figured out yourself how to restore the NatSpec format.

@bmann Honestly I am not interested in continuing to dedicate my time for Ethereum pro-bono, after doing so since mid-2017. If you want to take the charge, you're welcome; and you can talk to someone who works in the Foundation about getting collaborator access to this repo, e.g. @Souptacular, although the changes you listed are simple to do. However, until wikiJS 2.0 hits, I'm not convinced that the wikiJS site is better from a UI perspective. I like being able to use the sidebar, and search on the site didn't work when I tried. If there was a fully functional search function like Wikipedia that has search results including content in articles, you could do without the sidebar, although it can still help. IIRC I pointed out other issues in the mentioned issue thread.

I added a https://github.com/ethereum/wiki/wiki#see-also section referring to the JS site.

[ChrisChinchilla]

@jamesray1 Not strictly true, I am here, but mostly on the Solidity team, and I am keen to help more, I just don't know if anyone wants me to :/ And they are funding some docs work to other projects with grants. Docs are hard, especially for a bunch of disparate, but kind of connected projects.

[virgil]

You all may be satisfied with https://eth.wiki . Currently running the beta of WikiJS v2.

[bmann]

@virgil looks like https://en.ethereum.wiki/ is down? If you’re going to change URL, please redirect links from the old domain.

[ChrisChinchilla]

OK, couple of questions / thoughts @virgil

• How are people approved for writing / editing? I couldn't seem to edit anything, and the best balance may be anyone can edit, but changes have to be approved/discussed.
• Because of the above, I wasn't able to comment on the writing experience for people.
• I feel like ethereum.wiki might be a better domain. First if it has history, second as it's more memorable.
• I think we should also have some sort of domain forward from ethereum.org/wiki, wiki.ethereum.org etc
• I couldn't figure out if whisper.js allows for translations, but we probably do want to allow for en., de. etc domains.
• There's some duplication between the external resources listed here and the external resources on the new ethereum.org site, I think we should either keep them in sync for consistency, or drop them from here. Or this becomes the "official" resources page instead, but yeah, that requires discussion.

Those things aside (and at least a couple of them are important), how do we make this become the wiki?

[virgil]

@virgil looks like https://en.ethereum.wiki/ is down? If you’re going to change URL, please redirect links from the old domain.

Already did it. That's a browser cache issue. It works if you use http://en.ethereum.wiki on a browser with a cleared cache.

How are people approved for writing / editing? I couldn't seem to edit anything, and the best balance may be anyone can edit, but changes have to be approved/discussed.

Anyone with a github account can edit.

feel like ethereum.wiki might be a better domain. First if it has history, second as it's more memorable.

I lean toward eth.wiki just because it's shorter. I was also recommended to me because some chinese users have difficulty spelling "ethereum".

I think we should also have some sort of domain forward from ethereum.org/wiki, wiki.ethereum.org etc

Done.

I couldn't figure out if whisper.js allows for translations, but we probably do want to allow for en., de. etc domains.

I'll make it once WikiJS supports translations.

There's some duplication between the external resources listed here and the external resources on the new ethereum.org site, I think we should either keep them in sync for consistency, or drop them from here. Or this becomes the "official" resources page instead, but yeah, that requires discussion.

I anticipate there will be some duplication of content. And I predict the content on eth.wiki will probably end up being a superset of the content on ethereum.org.

[ChrisChinchilla]

@virgil

Are you sure about the access? I get "Unauthorized" on every page.

[bmann]

@virgil it really is down https://downforeveryoneorjustme.com/en.ethereum.wiki

[virgil]

Oh I fixed this. Even for HTTPs.

[faraggi]

Any updates on this thread? How about we bring it up again?

The content on this wiki is so outdated, yet gets so many views, that it's becoming a problem. I'm sure other teams and persons have had the same experience.

IMO, just deleting this is better than letting it hang here.