cassandra-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Eric Evans <eev...@rackspace.com>
Subject Re: configuration file comments on wiki
Date Fri, 13 Nov 2009 21:00:30 GMT
Dropping -dev (and hoping it sticks)...

On Fri, 2009-11-13 at 10:12 -0800, kevin wrote:
> it will be great to have it in just one place. if it is in two places it is
> going to be hard to figure out which is latest and correct.

Actually, I think it would be great to have it in both places, the
problem stems from each being updated independently (and yes, one of
them will almost certainly suffer from lack of updates). 

I don't suppose something like Doxygen could be made to work with xml?

> On Fri, Nov 13, 2009 at 8:30 AM, TuxRacer69 <tuxracer69@gmail.com> wrote:
> 
> > Hi Jonathan,
> >
> > That's me. I understand that it can be painful to update.
> >
> > However I would say that a project of the size and popularity of Cassandra
> > deserves a dedicated configuration documentation. Also the Wiki format
> > allows you to make links to other pages which obviously becomes
> > non-clickable when translated to XML. It allows you to add pictures too
> > which I plan to do to link the config parameters to an architecture
> > documentation (wiki).
> >
> > As per porting the wiki to 0.5, I volunteer to update the page (or create a
> > 0.5 version of that page);
> >
> > what do you think?
> >
> > Alex
> >
> >
> >
> > Jonathan Ellis wrote:
> >
> >> Hi,
> >>
> >> Someone has been industriously improving the documentation of the
> >> config file settings on the wiki.  I'd rather move that into the
> >> config file itself though rather than have it get out of date when we
> >> update things.  (E.g. moving from 0.4 to 0.5 RSN.)
> >>
> >> I'd appreciate it if you could submit a patch for the xml instead.

-- 
Eric Evans
eevans@rackspace.com


Mime
View raw message