Re: collective.xdv documentation

On 04/02/2010, at 6:38 AM, Alexander Limi wrote:

> In my (admittedly biased ;) opinion, theming is one of the things  
> that should possibly live outside of the "developer manual".

+1

on the same topic I think buildout related topics of install and  
deployment should probably be a separate manual (and really doesn't  
need to iive in svn either).

>
> The goal of xdv and why we want to transition to it is that people  
> should need to have very minimal (ideally none at all!) knowledge of  
> Plone, but still be able to put a new look on a Plone site.
>
> Having it as chapter N in a developer manual instead of a standalone  
> manual will make it less visible. Since they have two different core  
> audiences, I'd say that it's one of the manuals that it would make  
> sense to put it on the top level.
>
> Of course, this is my opinion, doc team makes final call, etc, etc. :)
>
> — Alexander
>
> 2010/2/3 Anne Bowtell <[email protected]>
> Apologies for cross-posting, I asked this question originally on the  
> Deliverance discussion list but it probably as much belongs here.   
> I'm interested to know opinions on where collective.xdv theming  
> documentation should live - given that it now has an entry in the  
> add-on products section of plone.org.
>
> In the docs section of plone.org, we've got Alex Limi's manual -  
> which,
> although about rules-based theming in general is really an  
> introduction
> to collective.xdv. We've also got Deny's more advanced XDV tutorial
> which is currently in the knowledge-base.
>
> My question is really about Limi's manual. In the docs re-organization
> this got absorbed into the core, into the theme reference manual - but
> possibly this wasn't the right thing to do - it isn't really core yet
> (PloneFormGen for instance which would be a comparable 'must have' is
> documented in its product area).
>
> Should we move Alex Limi's manual to the documentation area of the
> collective.xdv product? (we would need some kind of redirect to be  
> sure
> that the link in Veda's book didn't break). In my view the theme
> reference manual should simply have, at the moment, a review of the
> principles of rule-based theming and directions to where the
> documentation on collective.xdv, xdv and Deliverance can be found.
>
> I'm very happy to help to keep it up-to-date where-ever it lives,  
> but -
> to be honest, with my current workload, I'm struggling to catch up  
> with
> Plone 4 in the theme reference manual as a whole. So it might have  
> more
> of a chance outside of the core docs area.
>
> Any thoughts?
>
> Anne
>
>
> ------------------------------------------------------------------------------
> The Planet: dedicated and managed hosting, cloud storage, colocation
> Stay online with enterprise data centers and the best network in the  
> business
> Choose flexible plans and management services without long-term  
> contracts
> Personal 24x7 support from experience hosting pros just a phone call  
> away.
> http://p.sf.net/sfu/theplanet-com
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs
>
>
>
>
> -- 
> Alexander Limi · http://limi.net
> ------------------------------------------------------------------------------
> The Planet: dedicated and managed hosting, cloud storage, colocation
> Stay online with enterprise data centers and the best network in the  
> business
> Choose flexible plans and management services without long-term  
> contracts
> Personal 24x7 support from experience hosting pros just a phone call  
> away.
> http://p.sf.net/sfu/theplanet-com_______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs


------------------------------------------------------------------------------
The Planet: dedicated and managed hosting, cloud storage, colocation
Stay online with enterprise data centers and the best network in the business
Choose flexible plans and management services without long-term contracts
Personal 24x7 support from experience hosting pros just a phone call away.
http://p.sf.net/sfu/theplanet-com