diff --git a/README.mkd b/README.mkd
index 50c2f9b..269ca87 100644
--- a/README.mkd
+++ b/README.mkd
@@ -1,10 +1,12 @@
-# main README file for gitolite -- start here!
+# Hosting git repositories
 
 <a name="start"></a>
 
-The [install][install] document has a quick install section at the top for the
-impatient.  Just remember that "impatient" does not always mean "successful"
-;-)
+Gitolite allows you to setup git hosting on a central server, with
+fine-grained access control and many (many!) more powerful features.
+
+**Impatient?** The [install][install] document has a quick install section at
+the top.  Just remember that "impatient" does not always mean "successful" ;-)
 
 ----
 
diff --git a/doc/gitolite.conf.mkd b/doc/gitolite.conf.mkd
index 51779ef..f8c28b2 100644
--- a/doc/gitolite.conf.mkd
+++ b/doc/gitolite.conf.mkd
@@ -110,6 +110,10 @@ A "rewind" is more often called a "non-fast forward push"; see git docs for
 what that is.  The `+` was chosen because it is part of the "git push" syntax
 for non-ff pushes.
 
+Note that *tags* are generally considered "write once", so they are treated
+specially by gitolite: you need rewind permission (`RW+`) to *overwrite* a
+tag with a new value.
+
 In a later section you'll see some more advanced permissions.
 
 <a name="_how_rules_are_matched"></a>
diff --git a/doc/ssh-troubleshooting.mkd b/doc/ssh-troubleshooting.mkd
index babeecd..0254475 100644
--- a/doc/ssh-troubleshooting.mkd
+++ b/doc/ssh-troubleshooting.mkd
@@ -254,7 +254,7 @@ gitolite-admin repository with a fresh key, get a shell on the server and use
 the program called `gl-admin-push` that comes with gitolite.  See instructions
 [here][gssp].
 
-[gssp]: http://sitaramc.github.com/gitolite/doc/3-faq-tips-etc.html#_gl_server_side_push_bypassing_gitolite_for_the_gitolite_admin_repo
+[gssp]: http://sitaramc.github.com/gitolite/doc/3-faq-tips-etc.html#_gl_admin_push_bypassing_gitolite_for_the_gitolite_admin_repo
 
 <a name="_simulating_ssh_copy_id"></a>