On Wed, Feb 18, 2009 at 08:34:04AM +0000, Nigel Hamilton wrote:
> Earlier this year I came up with an idea for a new type of CPAN module
> that extracts the "::Gist" out of other modules. It's kind of like Adam
> Kennedy's ::Tiny modules except it is optimised for programmer wetware not
> software[3].
>
> ::Gist modules are simple, user-friendly and "don't make me think".
I'm not sure it'll work, but trying can't do any harm :-) I would suggest,
however, calling it ...::Essentials instead of ...::Gist, as "gist" is a
rarely-used word that won't mean anything to the majority of people who
don't speak English natively - and even native speakers might not
understand exactly what a ::Gist module is meant to be and how it
differs from ::Simple.
Something else to consider is that it's often poor documentation that's
the problem, not complicated interfaces. And the "poor" documentation
is often poor by dint of being ever-so-complete and ever-so-correct
without showing examples of common usage. So maybe contributing
HOWTO.pod files to distributions would be a way of achieving your aims.
I started work on CPAN::API::HOWTO a few months ago.
--
David Cantrell | Nth greatest programmer in the world
All praise the Sun God
For He is a Fun God
Ra Ra Ra!
_______________________________________________
BristolBathPM mailing list
[email protected]
http://mailman.bristolbath.org/mailman/listinfo/bristolbathpm
