Re: http://api.plone.org returns forbidden

On 08/07/2011, at 2:55 PM, Alex Clark wrote:

> On 7/8/11 12:53 AM, Dylan Jay wrote:
>> On 08/07/2011, at 2:33 PM, Alex Clark wrote:
>>
>>> On 5/27/11 9:55 AM, Alex Clark wrote:
>>>> On 5/27/11 8:10 AM, peter.seifert wrote:
>>>>> Visiting http://api.plone.org I got:
>>>>> Forbidden
>>>>> You don't have permission to access / on this server.
>>>>>
>>>>> Is this deliberate or will the API-Overview return?
>>>>
>>>>
>>>> Probably an oversight, please open a ticket: http://goo.gl/4Z2rp
>>>
>>> I don't know if you have opened a ticket, but I'm going to declare
>>> api.plone.org dead.
>>>
>>> I've tried several times to get a "modern" build of the api docs
>>> going,
>>> but I always end up running into some epydoc conundrum.
>>>
>>> While I'm sure we can all agree the api docs generated by epydoc are
>>> not
>>> what you would expect to find in a useful set of api docs, they
>>> still do
>>> provide some value to some people.
>>>
>>> So, I'd be in favor of resurrecting them at some point, but I'm  
>>> not in
>>> any hurry to do so.
>>>
>>>
>>> (Clearly we need to fix "forbidden" and redir somewhere, or put up a
>>> message, or something.)
>>
>> I'd suggest that we just include parts of the api into collective- 
>> docs
>> via the sphinx autodoc plugin. Instead of being comprehensive we can
>> start to include them in the parts of the manual it's appropriate.
>
> Cool, +1. Btw I had to disable collective.sphinx.includedoc to get
> readthedocs.org to fly. Why didn't this work? I see a release on PyPI…

I didn't end up using it for any of the code docs I included so it's  
not needed.
I put the docs as module level comments and used autodoc plugin instead.


>
>
> Alex
>
>
>
>>
>>
>>>
>>>
>>> Alex
>>>
>>>
>>>
>>>>
>>>>
>>>>>
>>>>> Thanks,
>>>>>
>>>>> Peter
>>>>>
>>>>> --
>>>>> View this message in context: http://plone.293351.n2.nabble.com/http-api-plone-org-returns-forbidden-tp6410815p6410815.html
>>>>> Sent from the Documentation Team mailing list archive at  
>>>>> Nabble.com.
>>>>>
>>>>> ------------------------------------------------------------------------------
>>>>> vRanger cuts backup time in half-while increasing security.
>>>>> With the market-leading solution for virtual backup and recovery,
>>>>> you get blazing-fast, flexible, and affordable data protection.
>>>>> Download your free trial now.
>>>>> http://p.sf.net/sfu/quest-d2dcopy1
>>>>
>>>>
>>>
>>>
>>> --
>>> Alex Clark · http://aclark.net
>>>
>>>
>>> ------------------------------------------------------------------------------
>>> All of the data generated in your IT infrastructure is seriously
>>> valuable.
>>> Why? It contains a definitive record of application performance,
>>> security
>>> threats, fraudulent activity, and more. Splunk takes this data and
>>> makes
>>> sense of it. IT sense. And common sense.
>>> http://p.sf.net/sfu/splunk-d2d-c2
>>> _______________________________________________
>>> Plone-docs mailing list
>>> [email protected]
>>> https://lists.sourceforge.net/lists/listinfo/plone-docs
>>
>>
>> ------------------------------------------------------------------------------
>> All of the data generated in your IT infrastructure is seriously  
>> valuable.
>> Why? It contains a definitive record of application performance,  
>> security
>> threats, fraudulent activity, and more. Splunk takes this data and  
>> makes
>> sense of it. IT sense. And common sense.
>> http://p.sf.net/sfu/splunk-d2d-c2
>
>
> -- 
> Alex Clark · http://aclark.net
>
>
> ------------------------------------------------------------------------------
> All of the data generated in your IT infrastructure is seriously  
> valuable.
> Why? It contains a definitive record of application performance,  
> security
> threats, fraudulent activity, and more. Splunk takes this data and  
> makes
> sense of it. IT sense. And common sense.
> http://p.sf.net/sfu/splunk-d2d-c2
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs


------------------------------------------------------------------------------
All of the data generated in your IT infrastructure is seriously valuable.
Why? It contains a definitive record of application performance, security 
threats, fraudulent activity, and more. Splunk takes this data and makes 
sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-d2d-c2