[Bioperl-l] Towards a 0.7 release

Hilmar Lapp hlapp@gmx.net
Fri, 10 Nov 2000 09:34:13 -0800


"Osborne, Brian" wrote:
> 
> To the group,
> 
> I would propose 6) Outline needs for documentation, then begin to assign
> writers to specific sections or areas.
> 
> I say this because I would be happy to work on documentation, if I only knew
> what the intention of the documentation is. For example, I consider good

The intention of the documentation is to enable a potential user of a
module to actually use it without pain. Pain in this context is caused by,
e.g., getting no idea of the context and purpose in which to use it,
getting no idea about the capabilities of the module, calling it with
non-existent methods or wrong parameters due to documentation bugs. Sample
code usually helps people a lot, because a literal description of usage is
subjectively biased by the writer and may not be as obvious for someone
else.

In general, people who use BioPerl and went through pain by doing so are in
the best position to contribute, because they already know which things
were most painful. :-)

	Hilmar

-- 
-----------------------------------------------------------------
Hilmar Lapp                                email: hlapp@gmx.net
GNF, San Diego, Ca. 92122                  phone: +1 858 812 1757
-----------------------------------------------------------------