[ZDP] Re: [Zope] The agony of the ZOPE Documentation

Chris Withers chrisw@nipltd.com
Wed, 24 May 2000 21:20:12 +0100


Maik Roeder wrote:
> We desparately need people helping !

Like I said to, but I got other presures (from my employer...)

> The problem is that not all stakeholders are working on this together.

And that's a surefire way to &$%^ it up and achieve nothing :(

> The ZDP project has got another server than the main Zope site, and
> there are only a few spare time developers working on this site. If
> we could work together with Digital Creations and perhaps on the
> same server as Zope.org, things would be much easier !

I'm inclined to agree, why have a ZD portal when you could just have a
Zope portal...

> This is a job that only DC can do right now. 

I don't agree, I think they have as little clue as anyone else about
where everything is documented ;-)

> The ZDP has "only" got
> the aim to point to existing stuff. Restructuring the existing docs
> is not our job.

Maybe it should be? How about rebuilding zope.org as a generic 'Zope
Portal' with the building and documenting work being done more by the
community? (ie: integrating ZDP and Zope.org)

> > > You can't even browse
> > > the documentation without clicking through a thousand different
> > > links.
> >
> > I agree here too :(
> 
> What documentation do you mean ?

I assumed he was talking about the ZDP interface.. the front page is
nice but the rest is still all over the place :(

The New Users & Developers title looks out of place... I think it wants
it's own bit as suggested on the ZDP Wiki...

cheers,

Chris

PS: Politeness disclaimer: It's late and I'm tired ;-)