[Mplayer-cvslog] CVS: main/DOCS codecs.html,1.101,1.102 faq.html,1.118,1.119 formats.html,1.52,1.53 sound.html,1.66,1.67 video.html,1.126,1.127

[Gabucino]

Diego Biurrun wrote:
>  > The same went with the DGA section.
> I wouldn't have taken it out, but this is probably a case where the
> TOC gets too specific.
Yes.


> Those sections shouldn't get numbered at all
Why not? It would look lame without numbers. Simply don't advertise.


> IMHO.  Have a look at one of those sections: "2.3.1.2.2.8 Known
> bugs".  That's six (!) levels deep.
Yes :) Maybe I'm perverted (of course), but I like that :))) And it's a
system, after all :)


> In bugreports.html you have removed the second level.
As I said, I didn't remove because it had 65535 levels, but because it
was useless to expand. So is bugreports.html


> I think we should follow a simple rule: If it has a number it belongs
> in the TOC.
I think humans spent enough time on this planet do follow _advanced_ rules :)
Mine is: "If it has a number, it belongs into the TOC. Except if it doesn't."


>  > The TOC is already very long, but we can't collapse it more, unfortunately.
> Easy reference, of course, that's what a TOC is for after all.
Easy AND short reference, IMHO.


> And people might also want to have a quick glance at, say,
> bugreports.html#crashes, like I do for example, because I still don't
> know the gdb stuff by heart.
I'll tell you a secret, even I peeked into bugreports.html for those
gdb lines :))) Until lately, I finally raped myself to learn
"disass $pc-32 $pc+32" by head :) Much better now :)


> I'd like to reverse this.
Request copied. Answer is: nope. :D


> While talking about TOCs: What about creating index.html that only
> contains the TOC?
A long long (uint64) time ago documentation.html was only the TOC, AFAIR.
I can't tell you the reason now, but that idea was abandoned.


> This way we might get rid of those strange sections that are links in
> documentation.html.
Ah, no. I like them. Freestyle. :)


> But it's probably a post 0.90 redesign issue.
Not really, the DOCS mostly does not care of releases :) Feel free to
throw redesign ideas to me :)

-- 
Gabucino
MPlayer Core Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 232 bytes
Desc: not available
URL: <http://lists.mplayerhq.hu/pipermail/mplayer-cvslog/attachments/20030129/2a506385/attachment.pgp>