From 5e44d0c6010c2ebcedc32988fcf119f8d0f42e3d Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Sun, 24 Apr 2011 12:50:42 +0200 Subject: contributing: Change some bits. --- contributing.mdwn | 80 ++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 55 insertions(+), 25 deletions(-) (limited to 'contributing.mdwn') diff --git a/contributing.mdwn b/contributing.mdwn index 191451a0..e3a7a1f1 100644 --- a/contributing.mdwn +++ b/contributing.mdwn @@ -14,39 +14,47 @@ License|/fdl]]."]]"""]] So, you are interested in contributing to the GNU Hurd project? Welcome! Every single contribution is very much encouraged. -There are various ways to contribute; read on about contributing to... +There are various ways to contribute; read up on contributing to... [[!toc levels=3]] If someone of you is lurking around here and would like to contribute, but -feels she / he could do so better under formal mentoring: please speak up at -one of the [[regular_IRC_meetings|IRC#regular_meetings]]! +feels she / he could do so better under formal mentoring: please +[[contact_us]], or just speak up at one of the [[regular IRC +meetings|IRC#regular_meetings]]! -Generally we also have a list of [[open_issues]] and one for -[[project_ideas|community/gsoc/project_ideas]] - the latter written for the -Google Summer of Code. Even just investigating open issues, without being able -to fix them, can be useful, because a tracked down issue often becomes obvious -to people who know the stuff (but those people don't have the time to spend to -do the tracking down). +We also have a list of [[open_issues]] and one for more elaborate [[project +ideas|community/gsoc/project_ideas]] - the latter originally written for the +[[Google Summer of Code|community/gsoc]], but not exclusively. Even just +investigating open issues, without being able to fix them, can be useful, +because a issue that has been tracked down often becomes obvious to address for +people who know the stuff -- but these people typically don't have the time +that is needed to track down the issues. # Documentation -## These Web Pages -Please read about [[how_to_contribute_to_these_web_pages|web_pages]]. +## Technical Writer + +Our hackers (programmers) typically do what their kind always does: they code. +What they don't like too much is documenting their wonderful achievements. On +the other hand, there are people (you?) who enjoy documenting technical +matters, so don't hesitate to [[contact_us]] if technical documentation shall +be your contribution to GNU Hurd development. + +## Web Pages -# The System Itself +Please read about [[how_to_contribute_to_these_web_pages|web_pages]]. -There are essential two kinds of Hurd system designs. - -## Hurd on Mach + +# Improve GNU Hurd Running on GNU Mach -For one there's the implementation of the *[[Hurd]] running on the -[[GNU_Mach_microkernel|microkernel/mach/gnumach]]*. This is what is commonly -meant when people are talking about GNU/Hurd systems. +The *[[GNU Hurd|hurd]] running on the [[GNU Mach +microkernel|microkernel/mach/gnumach]]* is what is commonly meant when people +are talking about GNU/Hurd systems. This system has mostly been designed and implemented [[in the '90s|history]]. It works and is usable. @@ -82,7 +90,8 @@ For more reading resources, please see these web pages, for example, [[Mach_documentation|microkernel/mach/documentation]] for links to a bunch of documents. -### Porting Packages + +## Porting Packages Debian is currently the Hurd distribution of choice among Hurd users and developers. @@ -95,14 +104,34 @@ doesn't work or suit you and try to improve that. You can also have a look at the [List of failing packages](http://people.debian.org/~sthibault/failed_packages.txt). -### Open Issues -Here is a list of [[open_issues]]. +## Open Issues + +There is a list of [[open_issues]]. This list includes everything from bug +reports to open-ended research questions. - -### Instant development environment + + +## Instant Development Environment + + *This is a very brief guide to get your development environment set up. Pester ArneBab @ irc.freenode.net on IRC if something does not work :)* +([[!taglink open_issue_documentation]]) * Install qemu-kvm via your distros packages. * Download the [qemu image](http://people.debian.org/~sthibault/hurd-i386/debian-hurd.img.tar.gz): `wget http://people.debian.org/~sthibault/hurd-i386/debian-hurd.img.tar.gz` @@ -120,8 +149,9 @@ Here is a list of [[open_issues]]. * Start hacking. * For shutting down, use `reboot`, then press `c` in grub and issue halt (to avoid filesystem corruption). Adding `--no-reboot` to the qemu line should help, too. - -## Hurd on a modern microkernel + + +# Design / Research: GNU Hurd on a Modern Microkernel Developers [[have_identified|hurd/critique]] a number of problem with the *Hurd on Mach* system. Problems, that can not easily be fixed by bug-fixing the -- cgit v1.2.3