Overview documentation overhaul (#1681)

* relocate Web3 Base API content from Overview * introduce new Overview content * plug the Overview in index.rst * add newsfragment + small copy cleanup * address PR feedback
ethereum · Jul 9, 2020 · 4984008 · 4984008
1 parent 55297bc
commit 4984008
Show file tree

Hide file tree

Showing 9 changed files with 543 additions and 285 deletions.
diff --git a/docs/ens_overview.rst b/docs/ens_overview.rst
@@ -1,3 +1,5 @@
+.. _ens_overview:
+
 Ethereum Name Service
 ================================
 

diff --git a/docs/ethpm.rst b/docs/ethpm.rst
@@ -1,3 +1,5 @@
+.. _ethpm:
+
 ethPM
 =====
 

diff --git a/docs/examples.rst b/docs/examples.rst
@@ -1,3 +1,5 @@
+.. _examples:
+
 Examples
 ========
 

diff --git a/docs/filters.rst b/docs/filters.rst
@@ -1,3 +1,5 @@
+.. _filtering:
+
 Filtering
 =========
 

diff --git a/docs/index.rst b/docs/index.rst
@@ -16,11 +16,12 @@ Getting Started
 
 Your next steps depend on where you're standing:
 
-- Unfamiliar with Ethereum? `ethereum.org`_
-- Looking for Ethereum Python tutorials? `ethereum.org/python`_
-- Ready to code? :ref:`quickstart`
-- Need help debugging? `StackExchange`_
-- Want to chat? `Gitter`_
+- Unfamiliar with Ethereum? → `ethereum.org`_
+- Looking for Ethereum Python tutorials? → `ethereum.org/python`_
+- Ready to code? → :ref:`quickstart`
+- Interested in a quick tour? → :ref:`overview`
+- Need help debugging? → `StackExchange`_
+- Want to chat? → `Gitter`_
 
 Table of Contents
 -----------------

diff --git a/docs/middleware.rst b/docs/middleware.rst
@@ -15,6 +15,8 @@ that are in deeper layers).
 More information is available in the "Internals: :ref:`internals__middlewares`" section.
 
 
+.. _default_middleware:
+
 Default Middleware
 ------------------