[BioPython] pending developmental release

Jeffrey Chang jchang@SMI.Stanford.EDU
Thu, 22 Jun 2000 23:47:48 -0700 (PDT)


> Yeah, I don't see a problem with that as long as it is near the later 
> part of next week. I have some stuff to clean up and also a few ideas 
> I want to try (which might make omniORB work) but just let me know a 
> date, and I can make it without a problem.

Great!  We'll make it at the end of the week, then.  Friday, or
Saturday...


> Jeff, if you want help with docs, this would be something I would be 
> happy to work on, so just let me know what your plan is for that and 
> what I can do.

Yes, that would be great.  I think what's most important is to have a
Tutorial so that people can pick this package up and immediately see how
to do some things.  It's intimidating to be thrown into a pile of modules,
with only docstrings as guides...

I've started the barest outline of a tutorial in
biopython/Doc/Tutorial.txt with some ideas of things to put in.  However,
I'm not set on the content.  In any case, we should target it toward as
wide an audience as possible, without having to give a CS or biology
lesson.

Is this what you had in mind to do?

Also, if you have any ideas on what kind of format we should use for
documentation (LaTeX, Word, HTML, Text, etc.), please let me know.  
Python doesn't have the nice POD or javadoc stuff...

Hmmm...  Most of the code does have docstrings, so we should look into the
state of docstring programs.


>     BTW, Jason (from Bioperl) and I have started working on 
> documentation for biocorba, so I hope that will be done by the time we 
> are ready for the alpha release.

Great!  Please send me a contributors to biopython-corba, so that I can
add them to the AUTHORS file.

Thanks,
Jeff