Wikis, and the need for a "Genode Book"

[Martin Stein]

Hi Steve,

El 8/4/19 a las 18:36, Steven Harp escribió:
> I also like the developer wiki idea. Risk: keeping a wiki accurate
> for an evolving system requires an investment of time...

I find it useful that, for instance, the online documentation of Ubuntu
normally tells you for wich versions of the system the article content
has been approved. In the Genode Wiki, the author of an article could
add the version he was using and other user can later add versions for
which they could apply the article successfully. As soon as information
in the article gets outdated, the affected parts could get split up by
another user with the newer version like this:

Step 1
======
...
Step 2
======
:For version X and Y:
...
:For version Z:
...
Step 3
======
...

When an article becomes too complicated to read because of this, it can
be split up completely into distinct articles about the same topic - for
instance, one named "Topic A, versions up to Y" and one named "Topic A,
versions beginning with Z". They would still contain the "approved
version" tags but one can easily decide which articles to skip just by
reading the title.

> Articles on networking would also be helpful. E.g., which of the common
> socket timeout techniques will work as they do in Linux?  A list of 
> known differences along these lines could be a great time saver.

I could add information about the native Networking components of Genode
but am not much into stuff like sockets and ported stacks ontop of that.

Cheers,
Martin