[ZF] hosting sphinx sites for zope projects?

Gary Poster gary at modernsongs.com
Wed Jun 24 07:36:07 EDT 2009


On Jun 24, 2009, at 7:18 AM, Christian Theune wrote:

> Hi,
>
> On Wed, 2009-06-24 at 12:17 +0200, Andreas Jung wrote:
>> On 24.06.09 12:07, Christian Theune wrote:
>>> Hi,
>>>
>>> On Tue, 2009-06-23 at 19:43 +0200, Martijn Faassen wrote:
>>>
>>>> Hi there,
>>>>
>>>> On Tue, Jun 23, 2009 at 7:37 PM, Jim Fulton<jim at zope.com> wrote:
>>>>
>>>>> Are there any plans to provide a place that zope developers can  
>>>>> post
>>>>> sphinx sites for zope projects?
>>>>>
>>>> We effectively have such a place in docs.zope.org, though mostly  
>>>> for
>>>> more meta-project material. I'd also like this to be a place to
>>>> publish project-specific documentation.
>>>>
>>>> I also think there is value in providing top-level *.zope.org names
>>>> for projects that really want to present their own identity; I  
>>>> think
>>>> this has helped Grok with grok.zope.org, for instance. For selected
>>>> projects we could consider making this possible.
>>>>
>>>> The important thing we want to prevent is overloading Jens with
>>>> requests. :) Jens, do you have any suggestions as to how we might
>>>> develop a procedure for this?
>>>>
>>> PyPI grew the ability to host package-specific documentation lately.
>>> Maybe we want to leverage that?
>> More information on that?
>
> Log in to PyPI, click on a package you own, go to the end of the page:
>
> "As an experimental service, you can now host documentation at
> http://packages.python.org/<yourpackage>. To upload documentation,
> prepare a .zip file that is unpacked into this URL. Only static pages
> are supported. The directory index file is index.html."

That's how zc.async's docs are hosted.  Works fine.  The feature has  
been there for close to a year, I'd guess.

Two possible advantages of zf hosting:

- if it is not "experimental," that's a win.

- Maybe it's a marketing boon (questionable in my mind, but maybe).

Gary



More information about the foundation mailing list