From bd7ac57f32fae7c1ce9bf1d72e32732e08bb19bc Mon Sep 17 00:00:00 2001
From: Chris Chinchilla <chris.ward@ethereum.org>
Date: Thu, 2 Jan 2020 14:09:43 +0100
Subject: [PATCH] Add new resources and change sort order

---
 docs/resources.rst | 40 +++++++++++++++++++++++-----------------
 1 file changed, 23 insertions(+), 17 deletions(-)

diff --git a/docs/resources.rst b/docs/resources.rst
index 3a9e3c0c2..02c1930aa 100644
--- a/docs/resources.rst
+++ b/docs/resources.rst
@@ -97,23 +97,38 @@ Discontinued:
 Solidity Tools
 ~~~~~~~~~~~~~~
 
+* `ABI to Solidity interface converter <https://gist.github.com/chriseth/8f533d133fa0c15b0d6eaf3ec502c82b>`_
+    A script for generating contract interfaces from the ABI of a smart contract.
+
 * `Dapp <https://dapp.tools/dapp/>`_
     Build tool, package manager, and deployment assistant for Solidity.
 
-* `Solidity REPL <https://github.com/raineorshine/solidity-repl>`_
-    Try Solidity instantly with a command-line Solidity console.
-
-* `solgraph <https://github.com/raineorshine/solgraph>`_
-    Visualize Solidity control flow and highlight potential security vulnerabilities.
-
 * `Doxity <https://github.com/DigixGlobal/doxity>`_
     Documentation Generator for Solidity.
 
 * `evmdis <https://github.com/Arachnid/evmdis>`_
     EVM Disassembler that performs static analysis on the bytecode to provide a higher level of abstraction than raw EVM operations.
 
-* `ABI to solidity interface converter <https://gist.github.com/chriseth/8f533d133fa0c15b0d6eaf3ec502c82b>`_
-    A script for generating contract interfaces from the ABI of a smart contract.
+* `EVM Lab <https://github.com/ethereum/evmlab/>`_
+    Rich tool package to interact with the EVM. Includes a VM, Etherchain API, and a trace-viewer with gas cost display.
+
+* `leafleth <https://github.com/clemlak/leafleth>`_
+    A documentation generator for Solidity smart-contracts.
+
+* `PIET <https://piet.slock.it/>`_
+    A tool to develop, audit and use Solidity smart contracts through a simple graphical interface.
+
+* `solc-select <https://github.com/crytic/solc-select>`_
+    A script to quickly switch between Solidity compiler versions.
+
+* `Solidity prettier plugin <https://github.com/prettier-solidity/prettier-plugin-solidity>`_
+    A Prettier Plugin for Solidity.
+
+* `Solidity REPL <https://github.com/raineorshine/solidity-repl>`_
+    Try Solidity instantly with a command-line Solidity console.
+
+* `solgraph <https://github.com/raineorshine/solgraph>`_
+    Visualize Solidity control flow and highlight potential security vulnerabilities.
 
 * `Securify <https://securify.ch/>`_
     Fully automated online static analyzer for smart contracts, providing a security report based on vulnerability patterns.
@@ -121,18 +136,9 @@ Solidity Tools
 * `Sūrya <https://github.com/ConsenSys/surya/>`_
     Utility tool for smart contract systems, offering a number of visual outputs and information about the contracts' structure. Also supports querying the function call graph.
 
-* `EVM Lab <https://github.com/ethereum/evmlab/>`_
-    Rich tool package to interact with the EVM. Includes a VM, Etherchain API, and a trace-viewer with gas cost display.
-
 * `Universal Mutator <https://github.com/agroce/universalmutator>`_
     A tool for mutation generation, with configurable rules and support for Solidity and Vyper.
 
-* `PIET <https://piet.slock.it/>`_
-    A tool to develop, audit and use solidity smart contracts through a simple graphical interface.
-
-.. note::
-  Information like variable names, comments, and source code formatting is lost in the compilation process and it is not possible to completely recover the original source code. Decompiling smart contracts to view the original source code might not be possible, or the end result that useful.
-
 Third-Party Solidity Parsers and Grammars
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~