Re: package pages

<smith@dybnet.de> wrote : > Hi, > > since time is short ... > > [13:01] <lsmith> hmm it should be possible to have a little custom > project page for each package > [13:01] <lsmith> for information that currently is not part of the pear > manual > [13:02] <lsmith> but that is of relevance to the project > [13:02] <lsmith> using the description section is not feasible often > [13:06] <Jan__> like what is not relevant for the manual ? > [13:08] <lsmith> well 1) not everybody has a docbook manual the second > it is released > [13:08] <lsmith> 2) stuff like screenshots > [13:08] <lsmith> 3) benchmark results > [13:08] <lsmith> 4) todo lists > [13:09] <lsmith> etc > [13:09] <_pierre> 1) a lot of people do not even use it ;-) > [13:10] <lsmith> _pierre: well everybody should work towards getting > some docbook documentation > [13:10] <lsmith> but ... > [13:10] <_pierre> sure, sometimes it s hard to tell 'enduser' to use it > ;-) > [13:11] <lsmith> and if there is docbook documentation available > [13:11] <lsmith> there should be a link from the package site to it > [13:11] <_pierre> +1 here for this kind of pages > [13:12] <lsmith> hmm time to mail another log to the list :-) > [13:12] <_pierre> :) > [13:12] <_pierre> time for food :) > [13:12] <_pierre> 'later > [13:12] <lsmith> do you think people would flame me if i did? > [13:13] <_pierre> no I'll try to make it short too, then. +1. The main reason my packages don't have docs for now is because I don't understand anything about what I have to do to write them, which tools, which format, which version. Every week I hear someone saying the new version of the doc is here and I see nothing. Every other week people talk about PHPDoc, PHPDocu, PHPDocumentor... This is too messy for me to get involved. Having a package page with screenshots and layout would be really cool and much more flexible than the DocBook boring stuff. Bertrand Mansion Mamasam