Re: collective.xdv documentation

Anne Bowtell wrote:
> 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.

An update on this:

In the past two days, Laurence and I have added some pretty 
comprehensive documentation to XDV (which you can see on PyPI at 
http://pypi.python.org/pypi/xdv, though it's updated even more in svn) 
and collective.xdv (unreleased for now, but see 
http://svn.plone.org/svn/collective/collective.xdv/trunk/README.txt).

In particular, there's a "worked example" for creating an XDV theme 
package that is redistributable and works with static content.

XDV has grown in the past few weeks and months, as has collective.xdv. I 
think this would be a great opportunity to revisit and consolidate the 
various XDV docs on plone.org, so that they are (a) relevant and (b) 
promote best practice.

I think in part these can refer to the above resources for reference 
info, but the more step-by-step approach of the tutorials, and coverage 
of important things like XPath and Firebug still have a place in more 
user-focused tutorials on plone.org.

If nothing else, consider that new people are likely to come to 
plone.org asking "how to I theme Plone". They are *not* likely to search 
PyPI for "XDV". ;-)

Martin

-- 
Author of `Professional Plone Development`, a book for developers who
want to work with Plone. See http://martinaspeli.net/plone-book


------------------------------------------------------------------------------
Download Intel® Parallel Studio Eval
Try the new software tools for yourself. Speed compiling, find bugs
proactively, and fine-tune applications for parallel performance.
See why Intel Parallel Studio got high marks during beta.
http://p.sf.net/sfu/intel-sw-dev