Documentation - request for feedback

[Nobody III]

I'm reading the documentation to get a better understanding of Genode. I am
a native English speaker, and I like most of what I've read so far, however
I have found a few errors. The most frequent error is incorrect punctuation
(e.g. placing commas where they don't belong). Though this is a minor
issue, it would be nice to get it fixed. I would do it myself as I read the
documentation if I could edit the PDF.
The biggest error that I have come across so far is on page 44 of
manual-2015-03-31: "Genode does hardly abstract from physical resources."
You could change it to something like "Genode doesn't abstract from
physical resources."
Overall, I am impressed with the documentation. You clearly have a very
good grasp of the English language--better than most people who speak
English as their first language. The documentation is very enlightening.
Thank you.

On Tue, Mar 31, 2015 at 5:20 PM, Norman Feske <norman.feske at ...1...>
wrote:

> Hallo,
>
> following up on our discussion one month ago, I have produced a new
> version of the document:
>
>
>
> http://genode.org/files/53bcb8e33fe6602fed25edc3c7b922c5/manual-2015-03-31.pdf
>
> In the meanwhile, it received the following new chapters:
>
>   2. Getting started
>   5. Development
>   7. Functional specification
>
> Content-wise it covers what I originally had in mind. Only the
> introduction is yet to be written and a few cross references are still
> missing. Do you miss a specific topic or find any part of the document
> too hard to swallow? Please let me know.
>
> Cheers
> Norman
>
> On 03/06/2015 04:22 PM, Norman Feske wrote:
> > Hello,
> >
> > according to our road map (http://genode.org/about/road-map), the
> > upcoming Genode version 15.05 will be accompanied with comprehensive
> > documentation. The work on this documentation is in full swing and can
> > be tracked at the corresponding Git repository:
> >
> >   https://github.com/nfeske/genode-manual
> >
> > A snapshot of the current version is available as PDF at:
> >
> >
> >
> http://genode.org/files/53bcb8e33fe6602fed25edc3c7b922c5/manual-2015-03-06.pdf
> >
> > So far, the work on the following chapters is completed already:
> >
> >   3. Architecture
> >   4. Components
> >   6. System configuration
> >   8. Under the hood
> >
> > I would greatly appreciate feedback from the community about those
> > chapters - be it in the form of minor spelling or grammar fixes,
> > suggestions for additional topics you wish to see covered, hints about
> > misleading paragraphs, or any other concerns that you may have.
> >
> > Cheers
> > Norman
>
>
> --
> Dr.-Ing. Norman Feske
> Genode Labs
>
> http://www.genode-labs.com · http://genode.org
>
> Genode Labs GmbH · Amtsgericht Dresden · HRB 28424 · Sitz Dresden
> Geschäftsführer: Dr.-Ing. Norman Feske, Christian Helmuth
>
>
> ------------------------------------------------------------------------------
> Dive into the World of Parallel Programming The Go Parallel Website,
> sponsored
> by Intel and developed in partnership with Slashdot Media, is your hub for
> all
> things parallel software development, from weekly thought leadership blogs
> to
> news, videos, case studies, tutorials and more. Take a look and join the
> conversation now. http://goparallel.sourceforge.net/
> _______________________________________________
> genode-main mailing list
> genode-main at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/genode-main
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.genode.org/pipermail/users/attachments/20150427/d5a5d73c/attachment.html>