diff --git a/docs/usage/subrepos.rst b/docs/usage/subrepos.rst
--- a/docs/usage/subrepos.rst
+++ b/docs/usage/subrepos.rst
@@ -1,10 +1,10 @@
 .. _subrepos:
 
 =============================================
-working with Kallithea and mercurial subrepos
+Working with Kallithea and Mercurial subrepos
 =============================================
 
-example usage of Subrepos with Kallithea::
+Example usage of Subrepos with Kallithea::
 
     ## init a simple repo
     hg init repo1
@@ -14,24 +14,23 @@ example usage of Subrepos with Kallithea
     hg ci --message "initial file 1"
 
     #clone subrepo we want to add
-    hg clone http://rc.local/subrepo
+    hg clone http://kallithea.local/subrepo
 
     ## use path like url to existing repo in Kallithea
-    echo "subrepo = http://rc.local/subrepo" > .hgsub
+    echo "subrepo = http://kallithea.local/subrepo" > .hgsub
 
     hg add .hgsub
     hg ci --message "added remote subrepo"
 
 
+In the file list of a clone of repo1 you will see a connected subrepo at
+revision it was during cloning.
+Clicking in subrepos link should send you to proper repository in Kallithea.
 
-In file list of repo1 you will see a connected subrepo at revision it was
-during cloning.
-Clicking in subrepos link should send you to proper repository in Kallithea
-
-cloning repo1 will also clone attached subrepository.
+Cloning repo1 will also clone attached subrepository.
 
 Next we can edit the subrepo data, and push back to Kallithea. This will update
 both of repositories.
 
-see http://mercurial.aragost.com/kick-start/en/subrepositories/ for more
-information about subrepositories
+See http://mercurial.aragost.com/kick-start/en/subrepositories/ for more
+information about subrepositories.