Hi
Ok Laszlo, a few comments on the documentation proposal:

The basic layout scheme seems good. I guess some of the parts will change as
they are filled in, but this offers an idea of what still needs to be done.
I'm not so keen on the color choices, I can not really read the red on
orange text, am not mad about the other colors, but I guess that's just a
style-sheet, that can be played around with later-on.
Some line-breaks are lost in the content, you're probably just pasting from
text-files though, which explains that.
Also, the type is very small, and can't be changed by the font-size chooser
in IE. this is because you use pt in the style-sheet. This is not simple,
some browsers pt stops resizing, in some px does. That's why I used em in my
style-sheet, but maybe there's some Linux/Mac issues with that, I don't
know.

Maybe people can test this, the same page with a different style-sheet, see
if font-sizes are acceptable, readable, and can be increased/decreased as
needed, over Linux/Mac/windows:
http://www.your-site.com/~rinfo/examples/php/doc_guide.html

http://www.interlog.com/~ccsi/DynAPI-Docs/docs/

To be perfectly honest I prefer my version (the first) it seems more
readable, and to have a nicer color-combination, but then I would wouldn't I
:o)

So basically I like what you've done, I think it allows people to take on a
particular part of the documentation, and should allow for a to-do list.
I'll be continuing with the Doxygen documentation, but have work to finish
by 1/Dec and 11/Dec, so not much time right now.

Cheers, Richard.


----- Original Message -----
From: "Laszlo Teglas" <[EMAIL PROTECTED]>


_______________________________________________
Dynapi-Dev mailing list
[EMAIL PROTECTED]
http://www.mail-archive.com/[email protected]/

Reply via email to