contributing: Shuffle some text.

2 files changed, 27 insertions, 36 deletions

diff --git a/contributing.mdwn b/contributing.mdwn
index 5d68f4ce..6ad4d709 100644
--- a/contributing.mdwn
+++ b/contributing.mdwn
@@ -9,11 +9,10 @@ Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
 is included in the section entitled [[GNU Free Documentation
 License|/fdl]]."]]"""]]
 
-So, you are interested in contributing to the GNU Hurd project?
+So, you are interested in contributing to the GNU Hurd project?  Welcome!
+Every single contribution is very much encouraged.
 
-Welcome!  Every single contribution is very much encouraged!
-
-There are various ways of contributing, read on about contributing to...
+There are various ways to contribute; read on about contributing to...
 
 [[!toc levels=3]]
 
@@ -64,10 +63,12 @@ on the skills you have and the resources you intend to invest.
 
 Please spend some time with thinking about the items in this [[questionnaire]].
 
-Before you can significantly contribute, take some time to learn about the
-system, e.g., [[microkernels_for_beginners|microkernel/for_beginners]].  Until
-you can do the basic exercises listed there, you won't be able to significantly
-contribute to the Hurd.
+Before you can significantly contribute to the operating system itself, you'll
+need to take some time to learn about the system, for example:
+[[microkernels for beginners|microkernel/for_beginners]], [[Mach's
+concepts|microkernel/mach/concepts]], [[Hurd's concepts|hurd/concepts]], the
+*[[hurd/critique]]*.  Until you can understand and do the basic exercises
+listed there, you won't be able to significantly contribute to the Hurd.
 
 For more reading resources, please see these web pages, for example,
 [[Hurd_documentation|hurd/documentation]] and
@@ -104,9 +105,9 @@ itself is more a research project than a *sit down and implement/code/hack*
 project.
 
 If you're interested in contributing in this area, knowing the *Hurd on Mach*
-system nevertheless is a prerequisite.  At least have a deep look at the
-documentation pointers given in the previous section.  Also read through the
-[[HurdNG|hurd/ng]] section.
+system (see [[above|contributing#hurd_on_mach]]) nevertheless is a
+prerequisite.  At least have a deep look at the documentation pointers.  Also
+read through the [[HurdNG|hurd/ng]] section.
 
 Please send email to the [[mailing lists/l4-hurd]] mailing list for discussing
 this post-Mach system design.
diff --git a/index.mdwn b/index.mdwn
index 9520a438..177c7a69 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -6,8 +6,8 @@ id="license" text="Permission is granted to copy, distribute and/or modify this
 document under the terms of the GNU Free Documentation License, Version 1.2 or
 any later version published by the Free Software Foundation; with no Invariant
 Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
-is included in the section entitled
-[[GNU Free Documentation License|/fdl]]."]]"""]]
+is included in the section entitled [[GNU Free Documentation
+License|/fdl]]."]]"""]]
 
 <div id="statements">
 <div id="what-is">
@@ -34,7 +34,7 @@ computing environment as possible.
 [[!toc levels=2]]
 
 
-## News
+# News
 
 [[!inline
 pages="news/* and !*/discussion"
@@ -56,24 +56,18 @@ developers' musings have a look at the [[shared weblog|community/weblogs]].
 The [[recent changes]] page lists the latest changes of this website.
 
 
-## Contributing
+# Contributing
 
-To help the Hurd you can for example (from high level stuff to the inner core)
-
-* [[Contribute_to_these_web_pages|contributing/web_pages]],
-* [[Run_a_GNU/Hurd_system|index#run]] and help others get their systems running, 
-* [[Port_applications|hurd/running/debian/porting]] to work in Hurd, 
-* Write [[translators|hurd/translator]] to extend the Hurd, 
-* Work on the [[Hurd_on_Mach|contributing#hurd_on_mach]], or
-* Help to port the Hurd [[to_a_modern_microkernel|contributing#hurd_on_modern_microkernel]].
+So, you are interested in contributing to the GNU Hurd project?  Welcome!
+Every single contribution is very much encouraged.  Please read our [[detailed
+recommendations about how to contribute|contributing]].
 
 See our [[source_repositories]] for the source code.
 
-Read about ways to contribute [[in_more_detail|contributing]].
 
-## Getting Help
+# Getting Help
 
-There are a couple of different [[Hurd_FAQs|hurd/FAQ]].
+There are a couple of different [[FAQ lists|FAQ]].
 There are a number of [[IRC_channels|IRC]] and several
 different [[mailing lists]] with searchable archives.
 
@@ -82,8 +76,9 @@ answer your own question using a search engine and reading the introductory
 information.  If you have done this and you cannot find the answer to your
 question, feel free to ask on a mailing list or on IRC.
 
+
 <a name="run"> </a>
-## Running the Hurd
+# Running the Hurd
 
 The most functional distribution of the Hurd is the one provided by Debian.
 Find more information about it at the
@@ -100,7 +95,7 @@ And these web pages are a living proof of the usability of the Hurd, as they
 are rendered on a [[Debian_GNU/Hurd|hurd/running/debian]] system.
 
 
-## Current Status
+# Current Status
 
 There has not yet been an official 1.0 release.  The Hurd is developed by a few
 volunteers in their spare time.  The project welcomes any assistance you can provide.
@@ -122,20 +117,15 @@ For more details, please read our writeup on the
 [[current_state_of_the_GNU_Hurd|hurd/status]]. 
 
 
-### Advantages and Challenges
+## Advantages and Challenges
 
 The GNU Hurd operating system design provides [[advantages]], but uncovers new
 [[challenges]], too.
 
 
-## How is this site arranged?
+----
 
-The menu on the upper right corner provides a rough structuring about the
-available content.  Just follow those topics and explore these pages.
+These pages are powered by [ikiwiki](http://ikiwiki.info/).
 
 Further information about this site and how it was created can be found in the
 [[colophon]].
-
-----
-
-These pages are powered by [ikiwiki](http://ikiwiki.info/).