diff --git a/README.md b/README.md
index 1a8ef7a..b9c9b7f 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # pertelian
 
-Python module to control the Pertelian X2040 LCD Display.
-
-Based on Pertelians Hardware Instruction Set Docs and damonkohler's pypert module.
+Python module to control the Pertelian X2040 LCD Display.  
 
+Based on Pertelians [Hardware Instruction Set Docs](src/branch/master/docs/hardware_instruction_set.md) and damonkohler's pypert module.  
 
+Check the file demo1.py for some example use of the library.
\ No newline at end of file