[wx-dev] r52800: [BP]: Removed manual [...] class category pages and replaced it with [..] auto-generated one

[Kit Bishop]

Bryan Petty wrote:
> On Wed, Mar 26, 2008 at 12:35 PM, Robert Roebling <robert at roebling.de> wr=
ote:
>   =

>>  I don't look at the full picture, I look at the HTML result used
>>  for finding information. The page that was there 24h ago perfectly
>>  did the job it was made for and the current replacement is worthless.
>>     =

>
> You're welcome...
>
> Four developers (Francesco, Kevin O, Chris Mellon, and myself) have
> agreed that this is the better solution (even if some had concerns
> about the same minor drawbacks you do), and yourself and Kit Bishop
> are the only ones that have said otherwise. I'd hardly call that
> "worthless".
>
> I'm having a hard time figuring out if Kit Bishop thinks that it's
> completely disappeared, or if he understands that it just changed from
> a single page listing to a single page per category listing.
>   =

To clarify my earlier comment - I took the original message to mean that
the
"Classes by Category" page was going to disappear altogether.  If, in fact,
what is actually going to happen is some sort of tabbed page with a tab for
each category or something similar, I would be quite happy.

Normally, I am looking to see what classes are available in what general
functional areas - if some general capabilty of this form is provided then
I'm happy with it.

Best regards,
Kit Bishop
> Anyway, this page may be important, but the type of usage it's meant
> for does not require that it's all on one page. If you're looking for
> a class, you already know the name, and should be looking in one of
> the alphabetical listings. The classes by category page is
> specifically meant for seeing what classes are available based on what
> kind of work you need done, it's supposed to be used when you aren't
> looking up a class by name. In doing this, you're not going to be
> performing a "Find" on the current page when you're looking through
> categories, and you typically only want to know about one specific
> category most of the time, so there's no point in loading up all of
> them at once and scrolling through the page.
>
> Regardless of this, there's more than enough benefits of doing it this
> way that it's well worth a few minor drawbacks (such as the order of
> the categories, which I agree, it is a small drawback). Additionally,
> the Doxygen manual also adds a search feature built into the online
> version of the manual, so this is even less of a concern now.
>
> Can you please at least show some respect for the fact that 1) I'm the
> only developer that has offered to help Francesco with this Doxygen
> migration (other than a few sparse commits by Vaclav), and 2) I have
> already proven I have the required experience for SVN access, and I
> know the general rules and guidelines around here. I was the one that
> started the thread on this subject two weeks ago well before I
> committed it, you missed your chance to speak up then, so you have no
> right talking down on me like it was an unwarranted commit and that I
> shouldn't have done it -- it was discussed.
>
> So rather than just commanding me to do your bidding (against the
> opinions of other developers here), can you please at least explain
> what the issue is. I've only been able to infer that you don't like
> the category ordering, or the fact that it was broken out into
> multiple pages, neither of which is a good enough reason to go back to
> the old page and forget about the benefits of using the Doxygen
> grouping.
>
> Regards,
> Bryan Petty
> _______________________________________________
> wx-dev mailing list
> wx-dev at lists.wxwidgets.org
> http://lists.wxwidgets.org/mailman/listinfo/wx-dev
>
>   =


-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.wxwidgets.org/pipermail/wx-dev/attachments/20080327/9ed26=
e4e/attachment.htm