Hey, several people showed some interest in helping
out with documentation of plex86 (FreeMWare), after
the recent Slashdot posting.
So, here's what would be a great start, and would
take no knowlege of coding internals at all.
Since the LDP has standardized on SGML/DocBook,
that's the logical choice for our docs. So, a
great first step, is to create the following
directories:
docs/DocBook
docs/html
Download the public paper on x86 virtualization
(it's plain ascii text), convert it to SGML/DocBook,
and put it in docs/DocBook format. Then create
a Makefile in the docs/ directory, which will drive
the tools needed to parse the DocBook file and
generate a corresponding file in docs/html.
Eventually, this Makefile will process all the
DocBook files and make html for web viewing,
or potentially PS files for printing, etc.
So make the Makefile target 'html', generate
the html files.
Since we're initially coding on Linux, we'll need
all the required tools to be accessible on Linux.
It would be very helpful, if you could also make
a document on how to download and install the
required tools.
For reference, the LDP is http://www.linuxdoc.org/
Many thanks,
-Kevin
