Ethdocs isn't maintained

Question

Ethdocs isn't maintained

jamesray1 opened this issue 7 years ago · 12 comments

There are 33 open PRs at the moment, starting from 21 Jun 2017, not including only one in 2016 that has conflicts.

Answer 1 · 2018-01-04T01:17:32.000Z

I've tried to raise this question, but it seems no one cares about it.

Answer 2 · 2018-01-04T01:23:35.000Z

I've created an unlicense for this repo in a PR here, so that the repo can be forked and modified by anyone, e.g. in this repo here.

Answer 3 · 2018-05-02T09:26:17.000Z

@jamesray1
OK cloning a repository that is not active enough is fine, now at https://github.com/Ethereum-community/homestead-guide

But how about updating https://ethereum-homestead.readthedocs.io/en/latest/ ?

Answer 4 · 2018-05-03T03:11:03.000Z

@paulvi TBH I haven't maintained https://github.com/Ethereum-community/homestead-guide either. I think having a wiki is a better approach, at least if there is nobody who is willing to make sure all changes are moderated. https://github.com/ethereum/wiki/wiki. Additionally now that Constantinople has been merged and we are now in part 1 of Metropolis, the Homestead guide is best used as a historical reference, IMO. The wiki is preferable for maintaining. If there are concerns with grafitti the content could be moved to a more moderated or moderatable wiki, e.g. like Bitcoin wiki.

Additionally the license for this repo was changed to CC BY-SA-4.0, so anyone should be able to edit it without having copyright issues now. I can add others as a contributor to that repo, however I suggest talking to maintainers here to discuss being added as a contributor to that repo, if interested. You could make a PR to update that page.

Answer 5 · 2018-05-03T06:46:33.000Z

Just learned that https://ethereum-homestead.readthedocs.io/en/latest/ = http://ethdocs.org/en/latest/

and while this repository says that

Legacy Docs
Ethereum Wiki: https://github.com/ethereum/wiki/wiki

That is wiki is legacy, in fact https://github.com/ethereum/wiki/wiki is still being updated.

So the first problem seems what is actually place for documentation?

Answer 6 · 2018-05-03T07:06:11.000Z

@jamesray1 Can you rename this issue to "this repository (Ethdocs) isn't maintained"
or even "THIS REPOSITORY (Ethdocs.org) IS NOT MAINTAINED"

Answer 7 · 2018-05-03T07:45:58.000Z

referencing @pirapira Yoichi Hirai who could do latest PR merges.

Answer 8 · 2018-05-03T09:05:02.000Z

@paulvi it may be a stretch to say that it is not maintained, maintainers may maintain it, albeit it may require prompting. I'll close this issue.

Answer 9 · 2018-05-03T09:06:09.000Z

I've been prompted. Currently six PRs are open, and I've left a comment on every one of them.

Answer 10 · 2018-05-03T09:07:56.000Z

I would say that https://github.com/ethereum/wiki/wiki is a more appropriate place for documentation. Vitalik Buterin, myself and others edit it. And anyone can freely edit it without having to be added as a collaborator to the repo or require collaborators to review PRs.

Yoichi, sorry to make it look like I was blaming you, note that I did say it it may require prompting. I haven't looked into the context.

Answer 11 · 2018-05-03T09:11:36.000Z

Regarding the legacy doc reference to the wiki I made a PR for that: #440.

Answer 12 · 2018-05-03T09:24:40.000Z

I also updated that PR to refer to the wiki as an alternative to this guide.