On Wed, Sep 20, 2006 at 11:07:27AM -0700, Darcy Buskermolen wrote:
> On Wednesday 20 September 2006 10:43, Christopher Browne wrote:
> > Andrew Hammond wrote:
> > > D. Aggressively encourage and support feedback, especially by new
> > > users so that the quality of the documentation can constantly be
> > > improved.
> >
> > I don't know how to do this in a useful fashion.  Not to pick at people,
> > but it's disappointing to see what amount to "slams" like the following:
> >
> > First impression: it looks cool but needs *much* better docs, plus some
> > handholding tools. Windows people will undoubtedly run a mile from this,
> > unless there are good tools I don't know about.
> >
> > <http://people.planetpostgresql.org/andrew/index.php?/archives/18-Slon-Rang
> >er.html#comments>
> >
> > I'd be more than happy to respond with improvements, if something more
> > specific was said than "needs *much* better docs."  I honestly don't
> > know what this "Yet Another Andrew" :-) has in mind when he says
> > "better."  If I did, I'd be entirely happy to try to address his issues.
> 
> Documentation is hard, and tends to be the least rewarding part of project 
> development.  Chris, I for one applaud the time and effort you have put into 
> the existing documentation, Because had you not, I don't think anybody else 
> would have and we'd still be saying better documentation is needed. Yes I 
> agree that better is an abstract term, but I belive the general consensus is, 
> replication is difficut enough without the tools (slony-I) being difficult to 
> understand.  I belive elein is working on more task centric documentation 
> which may be of a big help.

Just an aside, the slony user tutorial is still in progress.  A draft copy
can be found on http://www.varlena.com/Share/tutorial.pdf.  I'm looking to
get some heavy editing help.  And I'm trying to free up time to write and
test the ordinary operations that may be needed after the first successful
set up.  Feedback back to me.  Note that this is for dba people not knowledgeable
of slony internals.

--elein
elein at varlena.com

> 
> >
> > Unfortunately, it seems to be like pulling teeth to get responses more
> > specific than "better."  This is NOT a criticism of Andrew Dunstan; his
> > is an entirely typical sort of comment that I see across all kinds of
> > projects (not just Slony-I).  (I suppose I'm grousing a bit; it's
> > certainly not personal.  I also think BuildFarm docs could be better ;-).)
> > _______________________________________________
> > Slony1-general mailing list
> > Slony1-general at gborg.postgresql.org
> > http://gborg.postgresql.org/mailman/listinfo/slony1-general
> _______________________________________________
> Slony1-general mailing list
> Slony1-general at gborg.postgresql.org
> http://gborg.postgresql.org/mailman/listinfo/slony1-general
>