cassandra-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Eric Evans <john.eric.ev...@gmail.com>
Subject Re: NewBie Question ~ Book for Cassandra
Date Mon, 13 Jun 2016 14:47:15 GMT
On Mon, Jun 13, 2016 at 8:05 AM, Mattmann, Chris A (3980)
<chris.a.mattmann@jpl.nasa.gov> wrote:
> However also see that besides the current documentation, there needs to be
> a roadmap for making Apache Cassandra and *its* documentation (not *DataStax’s*)
> up to par for a basic user to build, deploy and run Cassandra. I don’t think that’s
> the current case, is it?

There is CASSANDRA-8700
(https://issues.apache.org/jira/browse/CASSANDRA-8700), which is a
step in this direction I hope.

One concern I do have though is that changing the tech used to
author/publish documentation won't in itself be enough to get good
docs.  In fact, moving the docs in-tree raises the barrier to
contribution in the sense that instead of mashing 'Edit', you have to
put together a patch and have it reviewed.

That said, I also think that we've historically set the bar way too
high to committer/PMC, and that this may be an opportunity to change
that; There ought to be a path to the PMC for documentation authors
and translators (and this is typical in other projects).  So, I will
personally do my best to set aside some time each week to review and
merge documentation changes, and to champion regular doc contributors
for committership.  Hopefully there are others willing to do the same!


-- 
Eric Evans
john.eric.evans@gmail.com

Mime
View raw message