[Zope-PTK] FYI: Sad news for PTK

Chris Withers chrisw@nipltd.com
Wed, 26 Apr 2000 18:31:12 +0100

I couldn't agree more about the documentation thing. It's what is really
holding Zope back in my opinion. I, and I'm sure many others, found it
very hard to get started because the documentation is scatterred exactly
as you describe.

I think ZDP should become the one and only source of Zope documentation.
Either that or it should have a bullet put through its head because it
confuses everyone ;-)

Furthermore, it should be genuinely accessible to the community for use
and for development.

yet another $0.02


Jimmie Houchin wrote:
> I subscribe to the ZDP list. I haven't contributed anything yet.
> However, what I was somewhat specifically refering to was the official
> Zope docs, the guides, et al. I don't know of the availability of those
> docs via cvs. There was mention of such possibility at one point, but
> haven't seen it since.
> I haven't yet gotten around to looking at the ZDP docs much yet. I think
> it would be nice if there were more of a central repository of Zope
> docs. Docs, how-tos, etc. are currently pretty scattered. The search
> facility on the Zope site at least the last time I looked didn't allow
> much access to the metadata of the documents. On the ZDP list I had a
> brief discussion with Alex Ratti (sp?) about this concerning the
> organization of his 'all how-tos' pdf.
> Right now it is difficult to put your hands on all of the material on
> any given subject. Being able to mine the knowledge of others better and
> easier would make the attainment of ZZen much easier. If that can be
> said. :)
> Jimmie Houchin
> Chris Withers wrote:
> >
> > > I would like to see alot of the Zope process open up like this. I would
> > > love to see this with the documentation. As I go through the docs I make
> > > notes in my printed copies of typos and legacy data. I would love to be
> > > able to check out the latest snapshot of the doc and commit some
> > > changes. It wouldn't bother me if they had to be approved by a 'trusted'
> > > individual first.
> >
> > hey! You can already :-)
> >
> > Check out zdp.zope.org. I'm sure they'll appreciate the help :-)
> >
> > good luck,
> >
> > Chris
> >
> > _______________________________________________
> > Zope-PTK maillist  -  Zope-PTK@zope.org
> > http://lists.zope.org/mailman/listinfo/zope-ptk
> >
> > See http://www.zope.org/Products/PTK/Tracker for bug reports and feature requests