Begin the long process of converting reStructuredText to markdown

.editorconfig

@@ -0,0 +1,2 @@
+[*.py]
+max_line_length = 79

pyproject.toml

@@ -45,6 +45,7 @@ transform = [
     "docc.python.transform",
     "docc.verbatim.transform",
     "docc.mistletoe.transform",
+    "docc.mistletoe.reference",
     "ethereum_spec_tools.docc.fix-indexes",
     "ethereum_spec_tools.docc.minimize-diffs",
     "docc.references.index",

setup.cfg

@@ -158,7 +158,7 @@ lint =
     flake8-spellcheck==0.28.0
 
 doc =
-    docc>=0.1.0,<0.2.0
+    docc>=0.2.0,<0.3.0
     fladrif>=0.2.0,<0.3.0
 
 optimized =

src/ethereum/__init__.py

@@ -1,6 +1,6 @@
 """
-Ethereum Specification
-^^^^^^^^^^^^^^^^^^^^^^
+### Introduction
+
 Seeing as internet connections have been vastly expanding across the
 world, spreading information has become as cheap as ever. Bitcoin, for
 example, has demonstrated the possibility of creating a decentralized,

src/ethereum/arrow_glacier/__init__.py

@@ -1,8 +1,6 @@
 """
-Ethereum Arrow Glacier Hardfork
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The Twelfth Ethereum hardfork.
+The Arrow Glacier fork delays the difficulty bomb. There are no other changes
+in this fork.
 """
 
 from ethereum.fork_criteria import ByBlockNumber

src/ethereum/arrow_glacier/utils/__init__.py

@@ -1,13 +1,3 @@
 """
-Hardfork Utility Functions
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. contents:: Table of Contents
-    :backlinks: none
-    :local:
-
-Introduction
-------------
-
-Utility functions used in this arrow_glacier version of specification.
+Utility functions unique to this particular fork.
 """

src/ethereum/berlin/__init__.py

@@ -1,8 +1,7 @@
 """
-Ethereum Berlin Hardfork
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-The Tenth Ethereum hardfork.
+The Berlin fork adjusts the gas costs of the `ModExp` precompile and several
+state access EVM instructions, introduces typed transaction envelopes along
+with the first new transaction type—optional access lists.
 """
 
 from ethereum.fork_criteria import ByBlockNumber

src/ethereum/berlin/utils/__init__.py

@@ -1,13 +1,3 @@
 """
-Hardfork Utility Functions
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. contents:: Table of Contents
-    :backlinks: none
-    :local:
-
-Introduction
-------------
-
-Utility functions used in this berlin version of specification.
+Utility functions unique to this particular fork.
 """

src/ethereum/byzantium/__init__.py

@@ -1,8 +1,7 @@
 """
-Ethereum Byzantium Hardfork
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The sixth Ethereum hardfork.
+The Byzantium fork reduces the mining rewards, delays the difficulty bomb,
+lets contracts make non-state-changing calls to other contracts, and adds
+cryptographic primitives for layer 2 scaling.
 """
 
 from ethereum.fork_criteria import ByBlockNumber

src/ethereum/byzantium/utils/__init__.py

@@ -1,13 +1,3 @@
 """
-Hardfork Utility Functions
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. contents:: Table of Contents
-    :backlinks: none
-    :local:
-
-Introduction
-------------
-
-Utility functions used in this byzantium version of specification.
+Utility functions unique to this particular fork.
 """

src/ethereum/constantinople/__init__.py

@@ -1,8 +1,7 @@
 """
-Ethereum Constantinople Hardfork
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The Seventh Ethereum hardfork.
+The Constantinople fork reduces mining rewards, delays the difficulty bomb,
+and introduces new EVM instructions for logical shifts, counterfactual
+contract deployment, and computing bytecode hashes.
 """
 
 from ethereum.fork_criteria import ByBlockNumber

src/ethereum/constantinople/utils/__init__.py

@@ -1,13 +1,3 @@
 """
-Hardfork Utility Functions
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. contents:: Table of Contents
-    :backlinks: none
-    :local:
-
-Introduction
-------------
-
-Utility functions used in this constantinople version of specification.
+Utility functions unique to this particular fork.
 """

src/ethereum/crypto/__init__.py

@@ -1,13 +1,3 @@
 """
-Cryptographic Functions
-^^^^^^^^^^^^^^^^^^^^^^^
-
-.. contents:: Table of Contents
-    :backlinks: none
-    :local:
-
-Introduction
-------------
-
-Cryptographic primatives used in Ethereum.
+Cryptographic primitives used in Ethereum.
 """

src/ethereum/dao_fork/__init__.py

@@ -1,8 +1,7 @@
 """
-Ethereum Dao Hardfork
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The third Ethereum hardfork.
+The DAO Fork is a response to a smart contract exploit known as the 2016 DAO
+Attack where a vulnerable contract was drained of its ether. This fork recovers
+the stolen funds into a new contract.
 """
 
 from ethereum.fork_criteria import ByBlockNumber

src/ethereum/dao_fork/utils/__init__.py

@@ -1,13 +1,3 @@
 """
-Hardfork Utility Functions
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. contents:: Table of Contents
-    :backlinks: none
-    :local:
-
-Introduction
-------------
-
-Utility functions used in this Dao Fork version of specification.
+Utility functions unique to this particular fork.
 """