Re: collective.xdv documentation
Alexander Limi <limi-z4DKO/[email protected]>
| Newsgroups | gmane.comp.web.zope.plone.documentation |
|---|---|
| Message-ID | <[email protected]> |
This is great! Although the introduction isn't really that useful, it references another product that people probably don't know about (Deliverance). A human-readable first paragraph will go a long way. I tried to come up with a good one, but failed. :P On Thu, Mar 25, 2010 at 9:01 AM, Martin Aspeli <[email protected]<optilude%[email protected]> > wrote: > 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 > _______________________________________________ > Plone-docs mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/plone-docs > -- Alexander Limi · http://limi.net ------------------------------------------------------------------------------ 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 _______________________________________________ Plone-docs mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/plone-docs