Re: Fwd: about GNU Hurd

[Thomas Schwinge]

Hello!

On Sat, Sep 15, 2007 at 05:39:07PM +0530, Vikram Vincent wrote:
> Forwarding this mail to bug-hurd which is the appropriate list for
> discussions related to the Hurd.

Indeed.


> ---------- Forwarded message ----------
> From: Shakthi Kannan <askshakthimaan@gmail.com>

> One of the best things I like about Free Software is its
> documentation. One just reads the manual or HOWTOs or documentation,
> and there is no reason to ask anybody in mailing lists, forums or IRC.
> Atleast, this has been my experience.
> 
> But, I was really stuck with incomplete documentation for Hurd. The
> Hurd Hacking Guide, for example, didn't take me much further (lot of
> TODOs):
> http://www.gnu.org/software/hurd/hacking-guide/hhg.html

For what it's worth, Ben Asselstine has been working on updating it.  A
pre-release of the updated version if being offered from
<http://www.asselstine.com/hhg.pdf>.  You may want to read that one.

> There are two types of coders I have seen. Some people just keep
> coding, coding, coding, and they know the code in and out. They don't
> require documentation.

Right.

> For some people, it is important to show them simple examples to get
> started with on various libraries, interfaces, functions etc., and
> then slowly they get to explore the different components of the code,
> and then really involve themselves with development.

Right.


> I request the core developers to spend some time with some
> documentation on the design, or enhance Hurd Hacking Guide
> documentation.

We're working on it.  Slowly, but steadily.  We're too few people to get
as much work done as we'd like.  But: everone of you can contribute!
Work through the update HHG, for example, and tell us about things you
don't understand or want to have changed.


Regards,
 Thomas

signature.asc
Description: Digital signature