Re: [Plone-docs] collective.xdv documentation

[Alexander L. <li...@pl...>]

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 <ann...@me...>

> 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
> Plo...@li...
> https://lists.sourceforge.net/lists/listinfo/plone-docs
>
>


-- 
Alexander Limi · http://limi.net