[Biopython-dev] Documentation

[Vince S. Buffalo]

Sounds good. I'll add a copy to doc/sphinxext as in Numpy.

By restricted, you mean without the :class:`ClassName` type annotation?

Vince

On Sun, Jul 18, 2010 at 5:28 AM, Peter <biopython at maubp.freeserve.co.uk>wrote:

> On Sun, Jul 18, 2010 at 11:52 AM, Peter wrote:
> > On Sun, Jul 18, 2010 at 7:50 AM, Vince S. Buffalo wrote:
> >> I dug into how Numpy is processing their own ReST dialect, and the
> >> answer lies in doc/HOWTO_BUILD_DOCS.txt. There is an extension
> >> that can be obtained from PyPi, or included manually in a doc/sphinxext
> >> directory.
> >>
> >> Are these extension requirements alright (before I continue changing the
> >> format)? Some more information is below.
> >
> > If they are useful, then I'm OK with that. We can probably even take
> > a copy and add it to the Biopython source code since it is under the
> > BSD licence: http://pypi.python.org/pypi/numpydoc/
> >
> > We may be fine with just restricted reStructuredText - see how you
> > get on with that first?
>
> Plus of course in the short term we'll still be using epydoc anyway.
>
> Peter
>



-- 
Vince Buffalo
Programmer
Bioinformatics Core
UC Davis Genome Center
University of California, Davis

"There's real poetry in the real world. Science is the poetry of reality."
-Richard Dawkins