Re: Documentation for ZopeSkel Efforts
Alex Clark <[email protected]>
| Newsgroups | gmane.comp.web.zope.plone.documentation |
|---|---|
| Message-ID | <C856A3A8.20188%[email protected]> |
Hi, On 7/4/10 7:02 AM, in article [email protected], "Israel Saeta Pérez" <[email protected]> wrote: > On 06/28/2010 09:19 PM, Elizabeth Leddy wrote: >> Hi all - >> >> I want to add some official documentation for zopeskel - where is the >> best place to do that? I know collective docs is the new hotness but I'm >> not sure who/what/how on updating that. The zopeskel stuff has several >> contributors so letting everyone have access would be ideal. > > Hey Elizabeth, > > sorry for so late reply - my university network filters the NNTP port. :( > > Being ZopeSkel a separated well-delimited package, I'd put its > documentation either inside the proper package README.txt file, > http://svn.plone.org/svn/collective/ZopeSkel/trunk/README.txt Or? > > > This would make the documentation available directly in the PyPI page. You can also host documentation on PyPI by uploading a zip file that has a top level index.html (e.g. Sphinx docs), but I have a feeling eleddy is looking for a more "central" place to host the ZopeSkel docs In fact, this reminds me of one of my yet-to-be-proposed-proposals I am considering for 4.1: Include ZopeSkel in Plone core. I won't fully propose it now (and the proposal would go to dev.plone.org as a plip), but in short: Mini-proposal: Include ZopeSkel in Plone core. ============================================= Why? --- Because (AFAIK) we eventually want Plone to be able to create packages TTW with the push of a button (a la Zenoss' ZenPacks). And ZopeSkel is the closest thing we've got to that right now. Also, it tends to not receive the proper care it deserves and incorporating it into the core would fix that. We could even enforce things like "every developer who adds a feature must update ZopeSkel to make that feature is easily customizable on the fs". Alex > > -- israel > > > ------------------------------------------------------------------------------ > This SF.net email is sponsored by Sprint > What will you do first with EVO, the first 4G phone? > Visit sprint.com/first -- http://p.sf.net/sfu/sprint-com-first -- Alex Clark · http://aclark.net Author Plone 3.3 Site Administration · http://aclark.net/admin ------------------------------------------------------------------------------ This SF.net email is sponsored by Sprint What will you do first with EVO, the first 4G phone? Visit sprint.com/first -- http://p.sf.net/sfu/sprint-com-first