summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Schwinge <thomas@schwinge.name>2010-12-21 12:55:05 +0100
committerThomas Schwinge <thomas@schwinge.name>2010-12-21 12:55:05 +0100
commit69cb8fe70e84b0f20add39ba1d30a0742a8d7b38 (patch)
treec373401c560efacc9611f661c8e7443ee82071f8
parent29b6f1b8a084c61d2d62d33e2d4413b91afae6e3 (diff)
contributing: Shuffle some text.
-rw-r--r--contributing.mdwn23
-rw-r--r--index.mdwn40
2 files changed, 27 insertions, 36 deletions
diff --git a/contributing.mdwn b/contributing.mdwn
index 5d68f4c..6ad4d70 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 9520a43..177c7a6 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/).