Re: [Plone-docs] Fwd: Help document Plone's API

[Vincent F. <vin...@gm...>]

On Wed, May 27, 2009 at 10:32 AM, Mikko Ohtamaa
<mik...@re...> wrote:
>> I also dislike reST. It's terribly strict and quite hard to use for
>> mere mortals.  I spend a lot of time fixing up reST long_descriptions
>> on collective packages (that aren't mine) just because I can't stand
>> to see the pages broken :D
>
> Check http://pypi.python.org/pypi/collective.checkdocs/0.1.1 for
> checking reST :)

Hi,

Tarek Ziade added a check distutils command in collective.dist, an
will be in Python 2.7 I think.
So you can do:
python setup.py check --strict
to check long_description reST.

You can do:
python setup.py --long-description | rst2html.py > /tmp/foo.html
and open /tmp/foo.html in your browser too.

Regards
-- 
Vincent Fretin