Asa Dotzler wrote: > I'd love to see people make this better. The catalog/ is just the docs/ > listing copied into a new format with more links added. In an ideal > world we'd have a system that let you view a massive flat list or a > catalog view from the same data. Right now they're both maintained by > hand and that sucks for both of them. I still think catalog makes a lot > more sense if it's done well. Maybe it just needs some help from the > experts (not that the experts were making /docs any better).
Bug 151961, if I recall correctly. We do need some help with developing tools for supporting documentation (bug 151952). This debate is very healthy for us. The bulk of our problem right now in terms of developing tools is lack of manpower. I've already brought that up more than once in the newsgroups, and I've been warned several times to get the word out beyond newsgroups (ie mozillazine and the like) by my peers here. I just don't want to look like I'm standing on my own if I make such a request, although I need to do something, and soon. > We suck wherever you look. I think a well organized catalog is a better > format that a big fat megalist like we currently have at docs/ but in > the end if they're both well done then they're just 2 different views on > the same data. Again, we are working on it, but in addition to gripes and eyeballs we need help. > It's a catalog, not the actual documentation. I think that some people > will prefer a single page with 500 links each matched with paragraph of > information about what you might find if you follow that link > (m.o/docs/) and others will prefer a dmoz/yahoo style catalog-directory > thing view. I prefer the second. You seem to prefer the first. Let's > make a system where both are different views on the same data and > everyone's happy. Amen. Alex Vincent Vallejo, CA
