List cleanup

1 files changed, 9 insertions, 19 deletions

diff --git a/hurd/documentation.mdwn b/hurd/documentation.mdwn
index a85f4d4f..b60617b5 100644
--- a/hurd/documentation.mdwn
+++ b/hurd/documentation.mdwn
@@ -10,18 +10,15 @@ is included in the section entitled
 [[GNU Free Documentation License|/fdl]]."]]"""]]
 
 # Introductory Material
-
   * [[What_Is_the_GNU_Hurd]]
-
   * [[Advantages]]
-
   * [[FAQ]]
-
   * [[*The_Hurd_and_Linux*|/hurd-and-linux]], a comment by Richard Stallman.
 
+<!-- This comment "pushes" RMS's comment back into the list. Markdown is just great. -->
+
   * [[*Towards_a_New_Strategy_of_OS_Design*|/hurd-paper]], an architectural
     overview by Thomas Bushnell, BSG, notably:
-
     * [[The design|/hurd-paper#design]]
     * [[Translators|/hurd-paper#translator]]
     * [[The auth translator|/hurd-paper#auth]]
@@ -29,8 +26,9 @@ is included in the section entitled
     * [[The exec translator|/hurd-paper#exec]]
     * [[The ftpfs translator|/hurd-paper#ftpfs]]
 
-  * [[*The_Hurd*|/hurd-talk]], a presentation by Marcus Brinkmann, notably:
+<!-- Push! -->
 
+  * [[*The_Hurd*|/hurd-talk]], a presentation by Marcus Brinkmann, notably:
     * [[How to get a port?|/hurd-talk#how]]
     * [[Pathname resolution example|/hurd-talk#pat]]
     * [[Mapping the POSIX Interface|/hurd-talk#map]]
@@ -39,10 +37,10 @@ is included in the section entitled
     * [[Password Server|/hurd-talk#pas]]
     * [[Process Server|/hurd-talk#pro]]
 
-  * The *[[translator_primer]]*.
-
-  * A document about *[[translators]]* by Marcus Brinkmann.
+<!-- Force push! -->
 
+  * [[*The Translator Primer*|Translator_Primer]].
+  * [[*A Document About Translators*|translators]] by Marcus Brinkmann.
   * [[*A_Critique_of_the_GNU_Hurd_Multi-server_Operating_System*|critique]], an
     analysis of the GNU Hurd on GNU Mach system, written by Neal Walfield and
     Marcus Brinkmann.
@@ -60,33 +58,25 @@ is included in the section entitled
 # Development
 
   * [[RPC]]: our usage of *Remote Procedure Call*s.
-
   * *[[The_GNU_Hurd_Reference_Manual|reference_manual]]*.
-
-  * The *[[Hurd_Hacking_Guide]]*, an introduction to GNU&nbsp;Hurd and Mach
+  * [[*The Hurd Hacking Guide|Hurd_Hacking_Guide]]*, an introduction to GNU&nbsp;Hurd and Mach
     programming by Wolfgang Jährling.
-
   * [*Manually Bootstrapping a
     Translator*](http://walfield.org/pub/people/neal/papers/hurd-misc/manual-bootstrap.txt),
     a text by Neal Walfield about how to *manually connect the translator to
     the filesystem*.
-
   * [[*The_Authentication_Server*|auth]], the transcript of a talk about the
     details of the authentication mechanisms in the Hurd by Wolfgang Jährling.
-
   * [*The Mach Paging Interface as Used by the
     Hurd*](http://lists.gnu.org/archive/html/l4-hurd/2002-06/msg00001.html), a
     text by Neal Walfield.
-
   * In the
     [[Position_paper_*Improving_Usability_via_Access_Decomposition_and_Policy*|ng/position_paper]]
     Neal Walfield and Marcus Brinkmann give an overview about how a future,
     subsequent system may be architected.
-
   * [*Generalizing mobility for the Hurd*](http://users.student.lth.se/cs07fh9/2009-hammar-hurd-mobility.pdf),
     a thesis written by Carl Fredrik Hammar,
     investigates the mobility aspect of stores
     and how it can be generalized and used for other applications.
     The background chapter may be of interest to new developers.
-
-  * [[Ada4Hurd]]: some tools to write translators with Ada
\ No newline at end of file
+  * [[Ada4Hurd]]: some tools to write translators with Ada