Link to restart_gitlab.md and some more fixes

doc/development/doc_styleguide.md

@@ -105,13 +105,19 @@ Inside the document:
 
 ## References
 
-- There are many cases that a restart/reconfigure of GitLab is required. To
+- **GitLab Restart:**
+  There are many cases that a restart/reconfigure of GitLab is required. To
   avoid duplication, link to the special document that can be found in
-  `doc/administration/restart_gitlab.md`. Usually the text will read like:
+  [`doc/administration/restart_gitlab.md`][doc-restart]. Usually the text will
+  read like:
 
     ```
-    Save the file and [reconfigure GitLab](../administration/restart_gitlab.md) for the changes to take effect.
+    Save the file and [reconfigure GitLab](../administration/restart_gitlab.md)
+    for the changes to take effect.
     ```
+  If the document you are editing resides in a place other than the GitLab CE/EE
+  `doc/` directory, instead of the relative link, use the full path:
+  `http://doc.gitlab.com/ce/administration/restart_gitlab.html`.
   Replace `reconfigure` with `restart` where appropriate.
 
 ## API
@@ -240,3 +246,4 @@ curl -X PUT -H "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" -d "restricted_signup_domai
 [cURL]: http://curl.haxx.se/ "cURL website"
 [single spaces]: http://www.slate.com/articles/technology/technology/2011/01/space_invaders.html
 [gfm]: http://doc.gitlab.com/ce/markdown/markdown.html#newlines "GitLab flavored markdown documentation"
+[doc-restart]: ../administration/restart_gitlab.md "GitLab restart documentation"