diff --git a/README.rst b/README.rst
index e55d10e..986e9b1 100644
--- a/README.rst
+++ b/README.rst
@@ -12,7 +12,7 @@ Hackaday.
 
 In contrast to other thread libraries such as `openscad-threads
 <http://dkprojects.net/openscad-threads/>`__, `yet another thread library
-<https://www.thingiverse.com/thing:2277141>`__, 'threads for screws and nuts V1
+<https://www.thingiverse.com/thing:2277141>`__, `threads for screws and nuts V1
 <https://www.thingiverse.com/thing:3131126>`__, and `threading.scad
 <https://www.thingiverse.com/thing:1659079>`__, threadlib does not make you look
 up diameters and pitches and maybe even thread-profiles in tables and norms: It
@@ -31,6 +31,7 @@ Creating a thread is as simple as
 to create a British Standard Pipe parallel external thread. 
 
 
+===========================
 Why you may want to use threadlib
 ==================================
 
@@ -40,14 +41,12 @@ Why you may want to use threadlib
 - creates working threads (clearances are left for production tolerances)
 - flexible:
   - choose the $fn you need to fit the rest of your design
-  - let threadlib tell you the thread specs so you can do with them what *you*
-    want
+  - let threadlib tell you the thread specs so you can do with them what *you* want
 - extensible: Add your own threads
 - tried and tested in the real world: Um no, not yet. But with your help, it
   will soon be.
 
 
-===========================
 Installation
 ===========================
 
@@ -63,11 +62,9 @@ Save all of these into your OpenSCAD `library folder
 
 threadlib:
 
-  - clone threadlib into the folder 'threadlib' inside your OpenSCAD library
-  folder
+Clone threadlib into the folder 'threadlib' inside your OpenSCAD library folder
 
 
-===========================
 Usage
 ===========================
 
@@ -121,18 +118,16 @@ Here, we have used the function thread_specs(...) to look up the threads
 specifications - including the recommended diameter of the support structure.
 
 
-===========================
 List of supported threads
 ===========================
 
 Currently, threadlib knows these threads:
 
-- Metric threads (coarse, fine, and super-fine pitches) M0.25 to M600
-- British Standard Pipe Parallel Threads G1/16 to G6
-- PCO-1881 (PET-bottle thread)
+- `Metric threads <http://mdmetric.com/tech/M-thead%20600.htm>`__ (coarse, fine, and super-fine pitches) M0.25 to M600
+- `BSP parallel thread <https://www.amesweb.info/Screws/British-Standard-Pipe-Parallel-Thread-BSPP.aspx>`__ G1/16 to G6
+- `PCO-1881 <https://www.bevtech.org/assets/Committees/Packaging-Technology/20/3784253-20.pdf>`__ (PET-bottle thread)
 
 
-===========================
 Extensibility
 ===========================
 
@@ -155,7 +150,6 @@ accomplished and get the fame you deserve: Send in your tried and tested threads
 for addition to threadlib!
 
 
-===========================
 Change Log
 ===========================
 
diff --git a/docs/imgs/bolt-M4.png b/docs/imgs/bolt-M4.png
index 4fcc331..35cc710 100644
Binary files a/docs/imgs/bolt-M4.png and b/docs/imgs/bolt-M4.png differ
diff --git a/docs/imgs/flexible.png b/docs/imgs/flexible.png
index d3451e9..b95d407 100644
Binary files a/docs/imgs/flexible.png and b/docs/imgs/flexible.png differ
diff --git a/docs/imgs/logo.png b/docs/imgs/logo.png
index 8c04ebd..1a14881 100644
Binary files a/docs/imgs/logo.png and b/docs/imgs/logo.png differ
diff --git a/docs/imgs/nut-M12x0.5.png b/docs/imgs/nut-M12x0.5.png
index 389ab47..7fbd84b 100644
Binary files a/docs/imgs/nut-M12x0.5.png and b/docs/imgs/nut-M12x0.5.png differ
diff --git a/docs/imgs/thread-G1o2-ext-10turns.png b/docs/imgs/thread-G1o2-ext-10turns.png
index 8603c01..5b5ecd0 100644
Binary files a/docs/imgs/thread-G1o2-ext-10turns.png and b/docs/imgs/thread-G1o2-ext-10turns.png differ
diff --git a/docs/imgs/thread-G1o2-ext.png b/docs/imgs/thread-G1o2-ext.png
index 859a47e..c12d964 100644
Binary files a/docs/imgs/thread-G1o2-ext.png and b/docs/imgs/thread-G1o2-ext.png differ