[BioPython] BioPython Intro Level Documentation

[Julius Lucks]

Hi All,

I think a wiki version of the documentation is a good idea - that way  
the community can expand on topics, add pages, re-organize etc.  But  
there are merits to a nice PDF version as well including the ability  
to read it offline, have it all in one place, etc.  Perhaps we can  
make a nicely formatted PDF (better than mediawiki's printable  
formatting) version of the package documentation (i.e. putting all  
the pages together in a sensible order, etc.) corresponding to each  
release of the code?  That way the documentation can evolve with the  
code, but you can always get a version of the documentation that will  
work with the version of the code you are using.

Cheers,

Julius

-----------------------------------------------------
http://openwetware.org/wiki/User:Lucks
-----------------------------------------------------



On Jan 19, 2007, at 8:23 PM, Chris Fields wrote:

>
> On Jan 19, 2007, at 7:02 PM, Michiel Jan Laurens de Hoon wrote:
>
>> Hi Julius,
>>
>> Thanks a lot for setting up the Getting Started page!
>> I completely agree, the current Biopython documentation is a bit
>> intimidating. So I think that a more introductory-level wiki page is
>> very useful. By all means, go for it!
>>
>> We should actually consider if it is better to move to a wiki-only
>> documentation. The current PDF-based documentation feels more  
>> tangible,
>> but it's harder to update. Opinions, anybody?
>>
>> --Michiel.
>
> ...
>
> There is a special link for all pages to display them as printable  
> versions (in the toolbox on the right side under the search box),  
> so if one could print to a PDF file then that should obviate most  
> conversion problems.
>
> Here's a direct link:
>
> http://biopython.org/w/index.php?title=Getting_Started&printable=yes
>
> chris
>
>