[MPlayer-dev-eng] Doc overhaul, first example

[Diego Biurrun]

Hi!

Please let us stay constructive this time around.  I think we might
finally be getting somewhere, the document Daniel presented looks like
a good start to me.

There are two points that we want to address by the doc rewrite:

1)  Overhaul the content and the structure.
2)  Use another, more flexible format.

These two goals are completely independent of each other.  We could
take the current docs and convert them to format xy now or we might
start rewriting the content of the docs and transition to a different
format later on.  Daniel is somewhat in between with his document in
XHTML, but this might be a good compromise as it is easy to transition
from XHTML to XML later on.

We should take this as an example.  Now we have seen what one of the
documents can look like in XHTML.  Daniel, you offered to convert the
docs to docbook earlier.  Might I take you up on that offer and ask
you to provide bugreports.html as docbook so that we can see what this
looks like and how easy/difficult it is to convert to other formats?
Maybe one of the LyX proponents can come up with bugreports.html in
LaTeX format so that we can compare the two alternatives?
Regards

Diego


Daniel Egger writes:
 > Am Son, 2002-03-03 um 13.04 schrieb Gabucino:
 > 
 > > > And unless one can tell me what exactly the goals of a new doc project would
 > > > be I couldn't name any better format.
 > > Others developers will.
 > 
 > I'm happily waiting for that moment.
 >  
 > > > It's not a patch, it's a new file.
 > > That's the problem.
 > 
 > I think it's the only way to conform with:
 > "Don't make cosmetic patches, rather redo it from scratch".
 > Well, that's exactly what I did: I took parts of the old content
 > and wrote the (x)html from scratch.