From aa36b4d7e5df48a9fcd488450cbe82ef5b265b82 Mon Sep 17 00:00:00 2001 From: Joe Date: Thu, 12 May 2022 14:41:57 +0100 Subject: [PATCH 1/5] add deprecation notice to readme --- README.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 9f10df82..7d504f91 100644 --- a/README.rst +++ b/README.rst @@ -9,7 +9,16 @@ Homestead-Guide .. |Gitter| image:: https://badges.gitter.im/ethereum/homestead-guide.svg :target: https://gitter.im/ethereum/homestead-guide?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge -The Ethereum Homestead Guide is the reference documentation accompanying the Homestead release of the Ethereum project. Note that sections of this guide may be outdated. The Guide may be considered to be a historic reference since Ethereum had the Metropolis phase 1 fork, `Constantinople `_. An alternative documentation base may be used at https://github.com/ethereum/wiki/wiki ("the Wiki"), which is being actively maintained, and is also freely editable by anyone with a GitHub account (while editing this repo requires making a PR and being merged by a collaborator, or accepting an invitation as a collaborator). Note that documentation in this guide that is still relevant could be moved to the Wiki. + +DEPRECATION NOTICE +------------------ + +The Ethereum Homestead Guide is the reference documentation accompanying the **Homestead release** of the Ethereum project. +The information in this repository is largely out of date. Relevant material has been migrated to ethereum.org +and this repository is **due to be archived shortly**. Pleas + + +Note that sections of this guide may be outdated. The Guide may be considered to be a historic reference since Ethereum had the Metropolis phase 1 fork, `Constantinople `_. An alternative documentation base may be used at https://github.com/ethereum/wiki/wiki ("the Wiki"), which is being actively maintained, and is also freely editable by anyone with a GitHub account (while editing this repo requires making a PR and being merged by a collaborator, or accepting an invitation as a collaborator). Note that documentation in this guide that is still relevant could be moved to the Wiki. `Hosted on ReadTheDocs`_ From 35475d4487b6e9c8c933f9d6f24f5da4a0af1bcf Mon Sep 17 00:00:00 2001 From: Joe Date: Thu, 12 May 2022 14:44:13 +0100 Subject: [PATCH 2/5] remove redundant text from readme notice --- README.rst | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/README.rst b/README.rst index 7d504f91..f0826ec4 100644 --- a/README.rst +++ b/README.rst @@ -11,17 +11,14 @@ Homestead-Guide DEPRECATION NOTICE ------------------- +================== The Ethereum Homestead Guide is the reference documentation accompanying the **Homestead release** of the Ethereum project. The information in this repository is largely out of date. Relevant material has been migrated to ethereum.org -and this repository is **due to be archived shortly**. Pleas +and this repository is **due to be archived shortly**. For current information on etheruem, please visit ethereum.org instead. +This repository is for historical reference only! -Note that sections of this guide may be outdated. The Guide may be considered to be a historic reference since Ethereum had the Metropolis phase 1 fork, `Constantinople `_. An alternative documentation base may be used at https://github.com/ethereum/wiki/wiki ("the Wiki"), which is being actively maintained, and is also freely editable by anyone with a GitHub account (while editing this repo requires making a PR and being merged by a collaborator, or accepting an invitation as a collaborator). Note that documentation in this guide that is still relevant could be moved to the Wiki. - -`Hosted on ReadTheDocs`_ - HOW YOU CAN HELP ================================================================================ **Homestead Documentation Initiative** From facc3f5d41765330ad33d0907cd678929ec54311 Mon Sep 17 00:00:00 2001 From: Joe Date: Thu, 12 May 2022 14:48:43 +0100 Subject: [PATCH 3/5] add external link to ethereum.org to readme --- README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.rst b/README.rst index f0826ec4..6efc9df4 100644 --- a/README.rst +++ b/README.rst @@ -14,8 +14,8 @@ DEPRECATION NOTICE ================== The Ethereum Homestead Guide is the reference documentation accompanying the **Homestead release** of the Ethereum project. -The information in this repository is largely out of date. Relevant material has been migrated to ethereum.org -and this repository is **due to be archived shortly**. For current information on etheruem, please visit ethereum.org instead. +The information in this repository is largely out of date. Relevant material has been migrated to https://ethereum.org. +and this repository is **due to be archived shortly**. For current information on Ethereum, please visit https://ethereum.org instead. This repository is for historical reference only! From 6e73d69a4e01011532af414aec2bc4c8ae6b7deb Mon Sep 17 00:00:00 2001 From: Joseph Cook <33655003+jmcook1186@users.noreply.github.com> Date: Mon, 16 May 2022 13:06:02 +0100 Subject: [PATCH 4/5] Update README.rst adds note directing contributors to etheruem.org Co-authored-by: Sam Richards --- README.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.rst b/README.rst index 6efc9df4..aa177780 100644 --- a/README.rst +++ b/README.rst @@ -21,6 +21,9 @@ This repository is for historical reference only! HOW YOU CAN HELP ================================================================================ + +Looking to contribute to Ethereum documentation? Check out the ethereum.org repo: https://github.com/ethereum/ethereum-org-website + **Homestead Documentation Initiative** It doesn't matter if you are a beginner or an expert, there are many ways to help. From 73cd29a0442a5f077b0bd20c6458761a0957688d Mon Sep 17 00:00:00 2001 From: Joseph Cook <33655003+jmcook1186@users.noreply.github.com> Date: Mon, 16 May 2022 13:08:55 +0100 Subject: [PATCH 5/5] remove redundant advice to contributors --- README.rst | 117 ----------------------------------------------------- 1 file changed, 117 deletions(-) diff --git a/README.rst b/README.rst index aa177780..740e8172 100644 --- a/README.rst +++ b/README.rst @@ -24,120 +24,3 @@ HOW YOU CAN HELP Looking to contribute to Ethereum documentation? Check out the ethereum.org repo: https://github.com/ethereum/ethereum-org-website -**Homestead Documentation Initiative** - -It doesn't matter if you are a beginner or an expert, there are many ways to help. - -Write Content to the Guide --------------------------------------------------------------------------------- -Help transfer and update content from the Ethereum Wiki, Ethereum Frontier Guide, the Ethereum Stack Exchange, or any other reputable source to relevant pages of the Homestead guide. Alternatively, write your own content for the guide based on experience. - -Make sure the documentation you are porting over is still accurate and follows our guidelines for the Homestead docs (https://ethereum-homestead.readthedocs.org/en/latest/about.html). - -Review What Has Been Written --------------------------------------------------------------------------------- -Have a look at our guide (https://ethereum-homestead.readthedocs.org/en/latest/) and give us feedback by visiting our Gitter Chatroom (https://gitter.im/ethereum/homestead-guide) or submit a pull request or issue to this repo. Too EZ. - -What's In It For Me? --------------------------------------------------------------------------------- -Your name will forever be immortalized, both in my heart and on the Contributors page in the guide. -As a side effect, you may also get those good feels that you get when you help improve documentation :-) - -GETTING STARTED -====================== - -This project uses Sphinx (http://www.sphinx-doc.org/en/stable/index.html) to build html that is published to Read the Docs. To run this documentation on your computer, you should do the following: - -Prerequisites --------------------------------------------------------------------------------- -* Python 2.6 or later -* git - -Install Sphinx, etc --------------------------------------------------------------------------------- -For OSX/Linux users (based on instructions here: https://read-the-docs.readthedocs.org/en/latest/getting_started.html). Sphinx as of 1.4.0 no longer automatically installs `sphinx_rtd_theme`, hence its addition below. - -* From command line: ``sudo pip install sphinx sphinx_rtd_theme`` - -For Windows users: - -* http://www.sphinx-doc.org/en/stable/install.html#windows-install-python-and-sphinx - -Get source code --------------------------------------------------------------------------------- -* git clone: https://github.com/ethereum/homestead-guide.git - -Build and view html --------------------------------------------------------------------------------- -* In a terminal window, go to your homestead-guide directory. -* ``make html`` -* ``cd build/html`` -* ``open index.html`` (open in web browser) -* Tip: each time you run ``make html``, just reload your browser to view changes - - -RESOURCES -================================================================================ - -**Homestead** - -* Homestead Guide online: https://ethereum-homestead.readthedocs.org/en/latest/index.html -* Github: https://github.com/ethereum/homestead-guide -* Gitter: https://gitter.im/ethereum/homestead-guide -* Google doc: https://docs.google.com/document/d/1rVjrNgaDRAQdPp4rGqWrEk5fPgiHff0xsYGCyf06oM8/edit - -**Legacy Docs** - -* Frontier Guide: https://ethereum.gitbooks.io/frontier-guide/content/ (see below for converted files) -* Souptacular's Giant List of Ethereum Resources: https://souptacular.gitbooks.io/ethereum-tutorials-and-tips-by-hudson/content/giant_ethereum_resource_list.html - -**Read the Docs and Sphinx** - -- Read the Docs: https://read-the-docs.readthedocs.org/en/latest/getting_started.html -- Sphinx docs: http://www.sphinx-doc.org/en/stable/contents.html -- reStructuredText Primer: http://www.sphinx-doc.org/en/stable/rest.html -- RST cheat sheet: https://github.com/ralsina/rst-cheatsheet/blob/master/rst-cheatsheet.rst - -Directory structure -========================= - -.. code-block:: - - homestead-guide - build - workdir, not commited to repo - source - actual content in rst - conf.py - sphinx configuration - old-docs-for-reference (Frontier era stuff) - wiki - the legacy wiki - gitbook - the legacy gitbook resources (converted to rst) - make.bat - windows command to build docs - Makefile - platforms with make to build docs - - -Roadmap for Homestead Guide (Old) -================================================================================ - -* boilerplate using sphinx-quickstart -* settings in `conf.py` -* code up index with proposed structure -* compile/deploy on readthedocs -* include cheatsheat, rst/sphinx/readthedocs resources -* reach out to community reddit - homestead documentation initiative -* allocate chapters to people (ideally author and reviewer) -* migrate old wiki under frontier/wiki (all md files converted to rst) -* migrate old frontier-guide content under frontier/gitbook (all md content converted to rst) -* script to annotate entire wiki with legacy warning - -Strategy for migrating old fronter-guide content (Old) -======================================================== - -* temporaritly include resources about the documentation project within the book itself - * rst cheatsheet - * rst/sphinx/readthedocs resources - * compilation/deployment instructions - * link to issues and process - * style guide, conventions -* include the rst conversion of the wiki -* include the rst conversion of the gitbook - -.. _Hosted on ReadTheDocs: https://ethereum-homestead.readthedocs.org/en/latest/