[Twisted-Python] Proposal (almost) to switch from Lore to Sphinx

[lasizoillo]

2009/11/11 Kevin Horn <kevin.horn at gmail.com>:
>
> I have written up a proposal here:
>
> http://twistedsphinx.funsize.net/proposal.html
>

In this proposal you say:

Development Work
 * fabric fabfile for automation of docs workflow

Future Work
 * This page has some stuff on using cog in RestructuredText comments
to generate the output of sample scripts.

The second point (in Future Work) uses cog that is integrated in paver:
 * Paver allow automation of docs workflow (fabric is not needed).
 * With paver you can create an bootstraped instalation:
    http://www.blueskyonmars.com/projects/paver/getting_started.html#but-people-don-t-have-paver-yet
 * Paver is compatible with setuptools and distutils.

I think that fabric is great for cluster distributions, but paver is
better for manage docs.

Regards,
 Javi