[ZODB-Dev] ZEO Web site maintenance

[Jeremy Hylton]

On Mon, 2003-09-22 at 09:55, John Belmonte wrote:
> Toby Dickenson wrote:
> > Im not sure who maintains the ZEO web site.... The first google hit for ZEO is 
> > http://www.zope.org/Products/ZEO, but that page only references obsolete 
> > releases :-(
> 
> I'll add +1 ":-(".  Trying to find "the real state of ZEO/ZODB" has been 
> an exercise in frustration.

Sorry about the /Products/ZEO page.  I added some text at the top that
explains that the page is obsolete.  I thought I had already made this
change; maybe I can blame the NZO transition for losing it <0.5 wink>.

> Most of the pages encountered by googling 
> seem years out of date.  

I didn't have patience to look beyond the first page, but it doesn't
seem as bad as all that.

www.zope.org/Products/ZEO: out of date (now fixed)
www.zope.org/Products/ZEO/ZEOFactSheet: still current, but no links
sourceforge.net/projects/zodb/: links to current Wiki page

None of the other links are to related to Zope's ZEO.

> The documentation included with the library is 
> in equally sad shape.  For example, I challenge anyone to find a record 
> of when user-level conflict resolution, which is not documented in the 
> distribution, was added to ZODB-- or the fact that the BTree classes 
> already use it.

AFAICT it was added in Zope 2.3.  In those days, I don't think anyone
was careful about recording changes.  The current ZODB releases are much
better about this; see the NEWS.txt file in a current release and you'll
find all the changes in great detail.

The documentation, on the other hand, has never seen a lot of
attention.  I'd be happy to spend more time on it, but paying work
doesn't leave a lot of time for it.

> As for the wiki's, I suppose we could start writing "this is obsolete" 
> on any pages that deserve it.

Or you could fix them so that they aren't obsolete.  A Wiki is a shared
effort.

Jeremy