[wx-dev] Re: Ideas for the doxydocs

[Bryan Petty]

On 3/4/08, Francesco Montorsi <f18m_cpp217828 at yahoo.it> wrote:
> should I assume that the page linked above is already ok?

Looks fine here, the version of Mac OS X pretty much defines the theme
used. More generally, just specifying 10.5 would be fine. It would be
preferable to have all screenshots under 10.5, though I think many are
still working off of 10.4 (such as myself), so not as many people will
be available to submit screenshots. Honestly though, I'm not sure how
much of a difference there is between the two, I don't think there is
much of one when it comes to the core widgets.

>  Maybe we should add screenshots for a larger number of controls?

I was thinking that this should hold off until the rest of the manual
is finished. This is delaying the conversion some, and the sooner
we're finished with the original contents of the manual, the sooner we
can stop worrying about out of sync edits (not that there would be
many even if we hadn't finished this conversion for another couple
months, but I'd feel better if the important parts were finished
first, we wouldn't be holding up a 2.9.0 release).

Aside from that though, I'm still hesitant about how many screenshots
we add to the manual. My HTML version of the manual is already bigger
than the LaTeX HTML version (compressed), and I only have half of the
classes in my version, and many of those still don't have any attached
documentation. We're going to easily double the size of the manual
download with the conversion to Doxygen already. I would like to see
screenshots in the manual, but they should really be kept to a
minimum, as in just the classes that it really helps to have them.

Regards,
Bryan Petty