Re: collective.developermanual is now on plone.org

On 24/01/2010, at 1:33 PM, Martin Aspeli wrote:

> Dylan Jay wrote:
>> Hi,
>>
>> The manual is now uploaded to the knowledgebase area[1]. I'm assuming
>> that the redesign will get rid of the authors attributions as that no
>> longer makes sense right? If not I'll get Mikko to reupload it as  
>> it's
>> mainly his work.
>> All the code for uploading will be in the buildout in
>> collective.developermanual shortly. Next step will be to setup  
>> regular
>> reuploads every night. Of course if anyone wants to contribute to the
>> manual just read [2]
>>
>> It's been transformed using transmogrifier blueprints from
>> pretaweb.funnelweb. There may be somethings not transformed right so
>> let me know and I'll fix them if I can. In particular PHC reference
>> manuals don't allow index pages so content from sphinx index pages is
>> currently missing. Also many of the styles aren't supported by this
>> plone theme so will need to be supported or transformed to something
>> that is.
>>
>> [1] http://plone.org/documentation/kb/collective.developermanual
>> [2] http://plone.org/documentation/kb/collective.developermanual/introduction/updating-this-document.html
>>
>> p.s.  Thanks Raphael, the api snippets did help me and in the end  
>> most
>> of the calls were even xmlrpc.
>> Thanks Mikko for the awesome start to manual and the others that have
>> contributed.
>
> I think it's really great that this has made its way to plone.org  
> where
> it belongs! ;-)

was always the plan :)

>
> I couple of suggestions:
>
>  - As Alex said, it's probably better as a manual than a kb article.

happy to put in the manual section if I get access.

> This really ought to be the basis for "the" manual for Plone  
> development
> in general.
>
>  - We shouldn't call it 'collective.developermanual'. That's the name
> of a Python package where we put some reST source code. It has no
> meaning to the intended audience and it's a terrible title. I'd just
> call it the "Plone Python Development Manual" or some such.

It was just a name to separate it from the other developer manual.
http://plone.org/documentation/manual/developer-manual/

Are we going to have two manuals in medium term till we workout which  
is the right way to go or pick one now?


------------------------------------------------------------------------------
Throughout its 18-year history, RSA Conference consistently attracts the
world's best and brightest in the field, creating opportunities for Conference
attendees to learn about information security's most important issues through
interactions with peers, luminaries and emerging and established companies.
http://p.sf.net/sfu/rsaconf-dev2dev