[Bioperl-l] 0.7 release: tasks & assignments

Osborne, Brian Brian.Osborne@osip.com
Thu, 30 Nov 2000 09:29:31 -0500

Hilmar et al.,

>>Second, I signed up Brian for creating more and 
>>especially better documentation.

First, I apologize for not responding earlier, like most of you
bioperl is a "labor of love", done outside of the 9 to 5. Regardless,
I accept the job. Though I won't be making the deadline with my own
task list I imagine it will look something like this :

- Reread and refamiliarize myself with the modules.
- Create prioriotized list of modules which could tell me where
to start. This list will be based on my experience as user, not
programmer. I'm assuming that all modules should be documented,
so the list simply tells me where to start, not what to do or not
to do. Perhaps we'd only want to focus on the very most stable
modules, in addition.
- Identify some small set of modules whose documentation I can emulate
(certainly this list will contain modules whose documentation is a
well balanced mixture of description and example) or offer to others
as examples.

As I begin to write I'm assuming a few things will happen. One could be
that authors are asked to document their public methods (should private
methods all be annotated too?). Another could be that authors could
be asked to write the "general" documentation of their modules. Certainly
I'll will be asking the group for example code, and looking through
bioperl.org for the same.

Talk to you soon,

Brian O.

-----Original Message-----
From: Hilmar Lapp
To: Bioperl
Sent: 29/11/00 12:35
Subject: [Bioperl-l] 0.7 release: tasks & assignments

As a reminder, the tentative task list for the 0.7 release will be
closed tonight PST, which is early morning tomorrow in Europe.

I will add one more, fairly small task, namely setting up a template for
good-style module creation, which shall also depict the 'right' way of
object initialization. Right now I'm having problems editing the Wiki


-------- Original Message --------
Subject: [Bioperl-l] 0.7 release: tasks & assignments
Date: Sun, 26 Nov 2000 19:46:43 -0800
From: Hilmar Lapp <hlapp@gmx.net>
Organization: Nereis 4
To: Bioperl <bioperl-l@bioperl.org>

After some days of silence, after curing the head-aches the upgrade of
my system caused me, I suggest that we come to terms regarding the tasks
we consider necessary in order to get the code 0.7 release ready. Since
Santa won't accomplish our tasks, this also means agreeing on assigments
regarding who's going to do what.

I extended the Wiki pages Jason started, check out
http://www.bioperl.org/wiki/html/BioPerl/BioperlRelease0.7.html. The
task list can be found at a link near the bottom (for the impatient:
http://www.bioperl.org/wiki/html/BioPerl/TaskList.html). Please check
out/review also the programming conventions, I made some additions
there, too.

Please thoroughly review this list. Since it is Wiki, you can edit it
directly, but you can also post to the list. Feel free to change
priorities, add tasks, add comments, etc. I made initial assignments
based on loose knowledge about who might be interested in what, please
check whether you find or would like to find yourself in a particular
cell. If you're there but don't want to be, please remove yourself. A
first review by myself suggests that I might be taking over too much, so
*please* feel encouraged to add yourself anywhere you can commit to,
regardless of whether there's already someone placed there.

There are two points I'd like to mention here because they might escape
you otherwise: I signed up Shailesh for testing on Win32, is there
someone out there who would be willing to test on Mac? Second, I signed
up Brian for creating more and especially better documentation. He needs
more hands for that task: *please* volunteer if you can spare some time.

I would like to get this list finalized by the middle of the week, say
Wednesday night, and by Friday night at the latest on condition that
some unforeseen delays happen (e.g. a shutdown of the internet,
bioperl.org goes on fire, etc). The next three days might be the last
chance to get your wish or concern considered for the 0.7 release, so
please speak out *now* if there's something itching you.

If you're worrying about tampering with the web-page, I have a backup
copy. Question to our Wiki-guys: is there a backup or any means of
restoring a page in the incident that someone wants to?

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