Re: collective.xdv documentation

Ah, I see. Well, I don't think there's any doubt that it's quickly becoming
best-practice (we have made lots of tweaks to 4.0 to make it work even
better), and it will be one of the cornerstones of Plone 5.

That being said, we probably need to make it a bit easier to get xdv up and
running, the primary issue right now is the sometimes-it-works-sometimes-not
binary egg for lxml on Windows/Mac.


On Wed, Feb 3, 2010 at 11:42 AM, Anne Bowtell
<[email protected]>wrote:

>  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]>
>
>> 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
>
>
>


-- 
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