[Cython] Anyone for a doc cleanup before the release?

Stefan Behnel stefan_ml at behnel.de
Fri Aug 10 22:10:38 CEST 2012


Dimitri Tcaciuc, 09.08.2012 05:40:
> On Tue, Aug 7, 2012 at 12:34 AM, Stefan Behnel wrote:
>> building the documentation currently yields a number of Sphinx warnings:
>>
>> https://sage.math.washington.edu:8091/hudson/job/cython-docs/lastSuccessfulBuild/warnings1Result/
>>
>> It would be nice if someone found the time to clean some of them up.
>
> Here's my go at it:
> 
>     https://github.com/cython/cython/pull/141

Thanks!

I'm reposting your questions here, in case someone has an opinion on them:

"""
What to do with duplicate citations (Sage, Pyrex). Perhaps make a separate
citations page?

What to do with sources that are not included anywhere (welcome,
userguide/numpy_tutorial, /userguide/pxd_package)

public keyword has a dual use; perhaps a section in reference/language
basics describing the two would be appropriate?

I've also tentatively enabled intersphinx extension to reference standard
python keywords, is that OK?
"""

Stefan



More information about the cython-devel mailing list