markdown cosmetics

README.md

@@ -31,20 +31,26 @@ with any web server. If you need a wsgi entry point, you can find one in
 ``wsgi/squirrel.wsgi``.
 
 ### Whitelist
-For each website which you want to SSO enable, you'll need to add them to the whitelist.
+For each website which you want to SSO enable, you'll need to add them to the
+whitelist.
 
-1. http://localhost:8001/admin
+1. ``http://localhost:8001/admin``
 
-  Login with admin user
+   Login with admin user
 
 2. Client Sites > Click Add 
 
-  *Note:* Don't confuse [Sites](http://docs.djangoproject.com/en/dev/ref/contrib/sites/) with Client Sites... They have very similar inputs and similar names.
+   *Note:* Don't confuse [Sites][DjangoSites] (i.e., the Django Sites framework)
+   with "Client Sites" (i.e., the SSO Whitelist)... They have very similar
+   inputs and similar names.
+
+[DjangoSites]: http://docs.djangoproject.com/en/dev/ref/contrib/sites/
 
 3. Enter Details
 
-  *Example:* 
-    Name: PHP Example App
-    Domain: phpclient.secretsquirr.el
-    Match priority: 0
-  Click Save
+    *Example:* 
+    Name: ``PHP Example App``
+    Domain: ``phpclient.secretsquirr.el``
+    Match priority: ``0``
+
+    Click Save

examples/example-php-cas-client/README.md

@@ -1,12 +1,14 @@
-# Example PHP CAS Client #
+Example PHP CAS Client
+======================
 
 This barebones PHP app can be used to test the Secret Squirrel server.
 
-# Setup #
-1) Mount $INSTALL_PATH/secret-squirrel/examples/example-php-cas-client/ somewhere in your apache or other PHP web server
-
-2) Run the squirrel on port 8001 or edit index.php
+Setup
+-----
+1. Mount ``$INSTALL_PATH/secret-squirrel/examples/example-php-cas-client/``
+   somewhere in your apache or other PHP web server
+2. Run the squirrel on port 8001 or edit index.php
 
     python runserver 0.0.0.0:8001
 
-3) Add your service URL to the whitelist
+3. Add your service URL to the whitelist