Dear PEAR developers,

The PEAR project is extremely impressive but - coming from a
non-professional developer who has struggled more than two months with
getting to grips with just one or two modules - what a steep learning

The technology, installers and coding standards all seem to be
perfectly worked out, but easily accessible documentation and
particularly examples are so lacking that most developers would rather
fiddle with self-developed libraries then invest the time to learn to
use PEAR. Isn't this a pity for a project that is supposed to give
developers such easy yet complete class libraries that they can get
beyond doing the "plumbing" themselves?

I understand that it is hard to find volunteers to write documentation.
But if you allow me just one crucial suggestion: PLEASE ADD a "User
Contributed Notes" section under every documentation page like the PHP
manual does. That way users who have written some good examples could
just post the code, and references to tutorials and articles could be
posted right beneath the function discussed in stead of in its separate

This all seems to work rather well on the PHP website. Wouldn't the
success of PEAR be greatly enhanced by following the same model there
and letting the community create accessible documentation for itself?

Just my €0.02...

With kind regards from Zurich

Roland Siebelink MBA
Managing Director
T+41-78-6288035, F+41-860-786 288 035

Avalu Ltd./AG - Management Consulting for the Individual
Technoparkstrasse 1
CH-8005 Zurich, Switzerland

Challenge your management thinking!

Search Discussions

  • Daniel Convissor at Nov 20, 2004 at 3:19 pm
    Hi Roland:
    On Thu, Nov 18, 2004 at 05:07:45PM +0100, Roland Siebelink wrote:

    But if you allow me just one crucial suggestion: PLEASE ADD a "User
    Contributed Notes" section
    That has been in the works for a while. It should be completed


    T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y
    data intensive web and database programming
    4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
grouppear-webmaster @
postedNov 18, '04 at 4:08p
activeNov 20, '04 at 3:19p



site design / logo © 2022 Grokbase