Re: Let's turn off api.plone.org.

On 21/08/2009, at 11:06 PM, Wouter Vanden Hove wrote:

> Dylan Jay wrote:
>
>
>> I think the closest is in Mikko/collective new developer  
>> documentation
>> even though it's not published on plone.org yet.

Sorry. I didn't mean to bring up the sphinx debate again. All I meant  
to say is that the introduction to that developer manual (the goal of  
which is to publish on plone.org) is the  perfect place to put the  
reading guide that Alex suggested. The reading guide is a fantastic  
idea. I think there are many fundamental concepts like object  
publishing that could provide more coverage for and reading guide  
would help that.

I think providing decent "written" developer documentation is the  
solution like grok or lxml. I think mikko's manual is a great start at  
that and the proposal to publish it into plone.org (and not some more  
obscure place like api.plone.org) is a the way to go.
if there is a genuine need to use some autogenerated documetnation as  
part of that process (such as roks ATCT schema doc generator) then  
great but it all should be inline and searchable with all other plone  
documentation.


------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day 
trial. Simplify your report design, integration and deployment - and focus on 
what you do best, core application coding. Discover what's new with 
Crystal Reports now.  http://p.sf.net/sfu/bobj-july