PEAR With User Comments

Hello all  This is a
simple message to tell you that
http://pear.php.net now
has user notes just like http://php.net.

Over the past few days we have worked very hard Greg and I
in order to
make the deadline for both the roadmap and personal goals
but now, we
have a functional user notes/comments on pear.php.net 

In order to add a note, you go to a package's address,
(http://pear.php.net/MDB2
) and click on Documentation, then when you
click on End-User documentation, you will now see the
"add a user
note/comment" at the bottom of the page. Note that this
is implemented
per-documentation-page and not per-package.

I have written most of it here:
http://blog.agoraprod
uction.com/index.php?/archives/30-PEAR-now-has-User-NotesCom
ments.html

But here's another update:
- Pear developers don't have to enter their username/email
when
entering a new comment and it will be automatically
authorized.
- Visitors will have to enter email, note and captcha, and
then it's
going to be set as pending, that one can later see in
(http://pear.php.net/
notes/admin/). Any pear devs has access to this
page and to approve comments. Also you will notice that
there is no
like approved -> back to pending, well this is commited
and is going
to be live on the next release of pearweb 

Thanks and hope you'll like it!

-- 
David Coallier,
Founder & Software Architect,
Agora Production (http://agoraproduction.com
)
51.42.06.70.18

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php

David Coallier wrote:

> Hello all  This is a
simple message to tell you that
> http://pear.php.net
now has user notes just like http://php.net.

Thanks for your (and Greg's) work, this is another often
requested
feature that was definitely missing.

There is one minor bug: I doubt that your note about MDB2
was written on
"31-Dec-1969 18:59". 

My test note on the same page has BTW the same (wrong) date.
As you
wrote yourself, it isn't yet possible to switch back from
approved to
pending. How about some buttons directly next to the notes /
comments
like in phpdoc? It is possible there to modify and delete
comments.

And what is the difference between notes and comments? I see
no
description about this difference. This should either be
explained or
both ways of commenting should be merged.

Two more problems:
- Opera 9 centers the text in the note box (header and
content), while
FF 2 and IE 7 use left-alignment (as I would expect it)
- my test comment on MDB2 is only shown when I'm logged in,
but when I
logout it isn't shown anymore

Finally: Can somebody please delete my test comment?
Thanks!

Regards,
Mark

-- 
http://www.markwiesemann.
eu

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php

Hi David,

Great news!

but what about the packages without end-user docs ?
there shouldn't be a way to post comments even tough it
would be
something like "hey dude, where is your documentation ?
I am waiting
for it... "  ;)

Cheers,
Igor.

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php

On 3/23/07, Mark Wiesemann <wiesemannphp.net> wrote:
> Finally: Can somebody please delete my test comment?
Thanks!

Google's rule #1 to rule the world: "never delete
anything"  =D

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php

Hoi Igor,

On 3/23/07, Igor Feghali <igor.feghaligmail.com> wrote:
> but what about the packages without end-user docs ?
> there shouldn't be a way to post comments even tough it
would be
> something like "hey dude, where is your
documentation ? I am waiting
> for it... "  ;)

You could file a bug.

-- 
  mit freundlichen Grüßen
  Markus Tacker

  kontaktdaten ~ http://m.tacker.org/kont
akt/

Mark, please fill in a bug report I"ll have it fixed
today 

Nop, I do not want to start commenting on stuff like this,
the user
notes/comments are to help documenting, if a package doesn't
have end
user documentation, it's their own problem. We have a
mailing list to
tell people that their doc is missing .



On 3/23/07, Markus Tacker <mtacker.org> wrote:
> Hoi Igor,
>
> On 3/23/07, Igor Feghali <igor.feghaligmail.com> wrote:
> > but what about the packages without end-user docs
?
> > there shouldn't be a way to post comments even
tough it would be
> > something like "hey dude, where is your
documentation ? I am waiting
> > for it... "  ;)
>
> You could file a bug.
>
> --
>   mit freundlichen Grüßen
>   Markus Tacker
>
>   kontaktdaten ~ http://m.tacker.org/kont
akt/
>


-- 
David Coallier,
Founder & Software Architect,
Agora Production (http://agoraproduction.com
)
51.42.06.70.18

--
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php

Igor Feghali wrote:
> On 3/23/07, Mark Wiesemann <wiesemannphp.net> wrote:
>> Finally: Can somebody please delete my test
comment? Thanks!
> 
> Google's rule #1 to rule the world: "never delete
anything"  =D

Hi Igor,

No note is ever truly deleted, it is simply marked with
status
approved="no"  This will allow easy retrieval of
accidental deletions,
although there is no automatic web interface for this yet.

Greg

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php

Igor, I am a google-way thinker and I stronly believe that
data
collection is what leads the world  I rarely
ever delete things in
my designs  Including
this one, we just mark them as approved no in
the db. 

On 3/23/07, Gregory Beaver <gregchiaraquartet.net>
wrote:
> Igor Feghali wrote:
> > On 3/23/07, Mark Wiesemann <wiesemannphp.net> wrote:
> >> Finally: Can somebody please delete my test
comment? Thanks!
> >
> > Google's rule #1 to rule the world: "never
delete anything"  =D
>
> Hi Igor,
>
> No note is ever truly deleted, it is simply marked with
status
> approved="no"  This will allow easy retrieval
of accidental deletions,
> although there is no automatic web interface for this
yet.
>
> Greg
>
> --
> PEAR Development Mailing List (http://pear.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub
.php
>
>


-- 
David Coallier,
Founder & Software Architect,
Agora Production (http://agoraproduction.com
)
51.42.06.70.18

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php