At 18:13 20.04.2002, Stas Bekman wrote:
Per Einar Ellefsen wrote:
At 17:09 20.04.2002, Bill Moseley wrote:
I think it's a good idea.  I haven't seen the text, but I can also see
Stas' point.  Could the top of the page have a simple link "What should I
read?" to a section at the bottom?

The text is very nice, but takes at least one page. Per Einar, can you please send it here (I can't find it)? Thanks!

Here it is: http://users.skynet.be/pereinar/mod-perl/docs/


For one thing that sentence "Tons of documents for you to learn from"
doesn't really fit, and I don't really see it, as my eyes just skip to the
first bold title.

Well, that's how I feel too. I think some explanation is necessary, even though it won't be read, because a seasoned reader will just skip it, while someone coming for the first time can try and navigate for himself, then come back if he didn't get it right.
I think your idea of moving it to the bottom and adding a link is a good one.

Me view is different. The /docs area is for heavy daily use and therefore
should be clean of noise. completely if possible. We have enough noise already with these
descriptions of each area. I'd even shorten this one. The titles are *very* descriptive already. But it's fine to keep as as they are.


it looks like /about is the area for newbies. Let's put the
"what should I read" there as a separate doc.

It's not only for the newbies. It's for corporate people too :)
Anyway, yes, I agree about that. But does this mean we shouldn't have any extra information on any page?


I'd even rename it to /start and put all kind of stuff for newbies to the site.

Hmm... nah, if we need to have extra newbie things, it should fit in the documentation.



-- Per Einar Ellefsen [EMAIL PROTECTED]



---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Reply via email to