Re: collective.xdv documentation

I'm definitely for the theming manual being separate from the 
developer's manual. More a question of whether collective.xdv - as an 
aspect of theming, should be part of our core set of reference manuals 
or should live outside of the core since for the moment it is an 
optional add-on (as for instance PloneFormGen documentation does).

Anne

On 03/02/2010 19:38, Alexander Limi wrote:
> In my (admittedly biased ;) opinion, theming is one of the things that 
> should possibly live outside of the "developer manual".
>
> 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] 
> <mailto:[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 <http://plone.org>.
>
>     In the docs section of plone.org <http://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]
>     <mailto:[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

begin:vcard
fn:Anne Bowtell
n:Bowtell;Anne
email;internet:[email protected]
tel;work:+44 (0)1865 882829
x-mozilla-html:FALSE
version:2.1
end:vcard