diff --git a/CHANGELOG b/CHANGELOG
new file mode 100644
index 00000000..62fd51eb
--- /dev/null
+++ b/CHANGELOG
@@ -0,0 +1,7 @@
+v1.1
+ - Added responsive design for mobile devices
+ - Mobile devices no longer load the background image to save the bandwidth and performance hit.
+
+v1.2
+ - Improved a documentation
+ - Updated demo links
diff --git a/README b/README
deleted file mode 100644
index e83d6cd0..00000000
--- a/README
+++ /dev/null
@@ -1,48 +0,0 @@
-=============================
-
-The Personal Page
-Version 1.1
-January 19, 2010
-Created by Naz Hamid
-Original: www.nazhamid.com
-License: MIT/GPL
-
-https://github.com/weightshift/The-Personal-Page
-http://weightshift.com/memo/the-personal-page
-
-The site makes use of the jQuery Backstretch plugin 
-from Scott Robbin. Gracias.
-http://srobbin.com/blog/jquery-plugins/jquery-backstretch/
-
-=============================
-
-This simple one-page website is a way for people to have a very quick and easy personable website that aggregates your activity and positions a simple logo, a portrait and some description text in a nicely-formatted manner. This is licensed under the MIT and GPL licenses. 
-
-See the original: http://nazhamid.com
-
-See others' versions:
-http://jenschuetz.com/
-http://timlum.com
-
-Usage is simple:
-
-1) You'll need to edit the index.html file with your own text.
-
-2) Upload your own logo in place of monogram.png. Your initials will likely not be NH, but if they are, be smart and use your own little monogram/logo. 
-
-3) Upload your own portrait as the background. Don't impersonate me!
-
-4) Upload all the files, including the MIT and GPL licences. 
-
-5) You can switch the position of the monogram and text as seen in timlum.com. 
-
-=============================
-Change Notes:
-=============================
-
-v1.1
-— Added responsive design for mobile devices
-— Mobile devices no longer load the background image to save the bandwidth and performance hit.
-
-
-
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..d7d810a4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+## The Personal Page
+This simple one-page website is a way for people to have a very quick and easy personable website that aggregates your activity and positions a simple logo, a portrait and some description text in a nicely-formatted manner.
+
+## Usage
+1. Edit the `index.html` file with your own text.
+2. Replace `monogram.png` with your own logo. Your initials will likely not be NH, but if they are, be smart and use your own little monogram/logo.
+3. Replace `nh.bg` with your own portrait for the background. Don't impersonate me!
+4. You can switch the position of the monogram and text as seen in http://timlum.com.
+5. Upload all the files on your server, including the MIT and GPL licences.
+6. If you don't have a server, you can use [github pages](https://help.github.com/articles/user-organization-and-project-pages). It's free.
+
+## Demo
+ - http://nazhamid.com
+ - http://jenschuetz.com/
+ - http://timlum.com
+ - http://alextamoykin.com
+ - http://weightshift.com/memo/the-personal-page
+
+## Gracias
+ - Naz Hamid for the [original work](http://nazhamid.com)
+ - Scott Robbin for [jQuery Backstretch plugin](http://srobbin.com/blog/jquery-plugins/jquery-backstretch/)
+
+## License
+This is licensed under the MIT and GPL licenses.