*To:* user@cassandra.apache.org
*Subject:* Re: Why is the cassandra documentation such poor quality?
I think the problem is a little deeper than that. I've been working with
cassandra for about 7 months now - it was very challenging to find out any
real information about using cassandra
On Thu, Jul 24, 2014 at 3:55 AM, Nicholas Okunew naoku...@gmail.com wrote:
most of the important stuff being in blog format
Which blog posts are you referring to? We could definitely have the docs
team integrate some of the blog post topics into the normal docs and keep
them updated for new
for starters all of the blog entries related to CQL3, like the change in
terminology and compact storage.
the last time I looked at the datastax documentation on CQL3, it wasn't
nearly as detailed as the blog entries by jonathan ellis and sylvain.
On Thu, Jul 24, 2014 at 12:07 PM, Tyler Hobbs
for example, this old blog entry from way back in 2012
http://www.datastax.com/dev/blog/cql3-for-cassandra-experts
On Thu, Jul 24, 2014 at 12:07 PM, Tyler Hobbs ty...@datastax.com wrote:
On Thu, Jul 24, 2014 at 3:55 AM, Nicholas Okunew naoku...@gmail.com
wrote:
most of the important stuff
A lot of the information about the compaction strategies would be
incredibly useful in the docs as well:
http://www.datastax.com/dev/blog/leveled-compaction-in-apache-cassandra
On Thu, Jul 24, 2014 at 9:45 AM, Peter Lin wool...@gmail.com wrote:
for example, this old blog entry from way back in
Subject: Re: Why is the cassandra documentation such poor quality?
On Thu, Jul 24, 2014 at 3:55 AM, Nicholas Okunew naoku...@gmail.com wrote:
most of the important stuff being in blog format
Which blog posts are you referring to? We could definitely have the docs team
integrate some
*To:* user@cassandra.apache.org
*Subject:* Re: Why is the cassandra documentation such poor quality?
On Thu, Jul 24, 2014 at 3:55 AM, Nicholas Okunew naoku...@gmail.com
wrote:
most of the important stuff being in blog format
Which blog posts are you referring to? We could definitely have
content in them
definitely needs to be in the docs as well.
-- Jack Krupansky
*From:* Tyler Hobbs ty...@datastax.com
*Sent:* Thursday, July 24, 2014 12:07 PM
*To:* user@cassandra.apache.org
*Subject:* Re: Why is the cassandra documentation such poor quality?
On Thu, Jul 24, 2014 at 3:55 AM
Hi Kevin,
The difference here is that the Apache Cassandra site is maintained by the
community whereas the DataStax site is maintained by paid employees with a
vested interest in producing documentation.
With DataStax having some comprehensive docs, I guess the desire for people
to maintain the
Just a note:
If you have suggestions how to improve documentation on the datastax website,
write them an email to d...@datastax.com. They appreciate proposals :)
Am 23.07.2014 um 09:10 schrieb Mark Reddy mark.re...@boxever.com:
Hi Kevin,
The difference here is that the Apache Cassandra site
I would like to help out with the documentation of C*. How do I start?
On Wed, Jul 23, 2014 at 12:46 PM, Robert Stupp sn...@snazy.de wrote:
Just a note:
If you have suggestions how to improve documentation on the datastax
website, write them an email to d...@datastax.com. They appreciate
I've tried to contribute docs to Cassandra wiki in the past, but there's an
obstacle.
currently wiki.apache.org/cassandra is locked down, so only commiters can
edit it. I really wish that wasn't the case, since it wastes time. the
commiters are busy writing code. Having to email a commiter and
It only takes a moment to ask to be added as a wiki contributor; if you
email the dev list or ask on irc, somebody with privileges will ordinarily
add you within a day. It may be a psychological barrier, but it isn't
really a practical one. Still, if you feel the policy is incorrect, raise
this on
sharing knowledge on
this list is always a big step forward.
-- Jack Krupansky
From: spa...@gmail.com
Sent: Wednesday, July 23, 2014 4:25 AM
To: user@cassandra.apache.org
Subject: Re: Why is the cassandra documentation such poor quality?
I would like to help out with the documentation of C*. How do
I've submitted requests to edit the wiki in the past and nothing ever got
done.
Having been an apache committer and contributor over the years, I can
totally understand that people are busy. I also understand that most
developer find writing docs tedious.
I'd rather not harass the committers
is the cassandra documentation such poor quality?
I would like to help out with the documentation of C*. How do I start?
On Wed, Jul 23, 2014 at 12:46 PM, Robert Stupp sn...@snazy.de wrote:
Just a note:
If you have suggestions how to improve documentation on the datastax
website, write them an email
All requests I've seen in the past year to edit the wiki (admittedly only
2-3) have been answered promptly with editing privileges. Personally I
don't have a major preference either way for policy - there are positives
and negatives to each approach - but, like I said, raise it on the dev list
and
I sent a request to add a link my .Net driver for cassandra to the wiki
over 5 weeks back and no response at all.
I sent another request way back in 2013 and got zero response. Again, I
totally understand people are busy and I'm just as guilty as everyone else
of letting requests slip by. It's
To: user@cassandra.apache.org
Subject: Re: Why is the cassandra documentation such poor quality?
I sent a request to add a link my .Net driver for cassandra to the wiki over 5
weeks back and no response at all.
I sent another request way back in 2013 and got zero response. Again, I totally
*Subject:* Re: Why is the cassandra documentation such poor quality?
I sent a request to add a link my .Net driver for cassandra to the wiki
over 5 weeks back and no response at all.
I sent another request way back in 2013 and got zero response. Again, I
totally understand people are busy
Requesting a change is very different to requesting permission to edit
(which, I note, still hasn't been made); we do our best to promote
community engagement, so granting a privilege request has a different
mental category to a random edit request, which is much more likely to be
forgotten by any
On Wed, Jul 23, 2014 at 1:30 PM, Peter Lin wool...@gmail.com wrote:
I sent a request to add a link my .Net driver for cassandra to the wiki
over 5 weeks back and no response at all.
TL;DR There is something wrong with Cassandra information sharing, but I am
partly to blame.
My experience has
@benedict - you're right that I've haven't requested permission to edit.
You're also right that I've given up on getting edit permission to
cassandra wiki. I've been struggling and struggled with how to manage
open source projects, so I totally get it. Managing projects is a thankless
job most of
We had a massive spam problem before we locked down the wiki, so
unfortunately that was the choice we had to make. But as stated we can
add you to the contributers list.
What is your Wiki user name?
On 2014-07-23 07:33, Peter Lin wrote:
I've tried to contribute docs to Cassandra wiki in
I'll note that historically the wiki used to be open to all and due massive
amounts of spam it was put on lockdown by the ASF.
If there is a better platform the community feels would make it simpler to
provide community based documentation then we should consider it.
The ASF also has confluence
My experience is similar to Nicholas'. Basic usage was easy to get a handle
on, but the advanced tuning/tweaking info is scattered EVERYWHERE around
the web, mostly on personal blogs. It feels like it took way too long to
become confident enough in my understanding of Cassandra that I trust our
On Wed, Jul 23, 2014 at 4:55 AM, Jason Wee peich...@gmail.com wrote:
I agree to the people here already sharing their ways to access
documentation. If you are starter, you should better spend time to search
for documentation (like using google) or hours to read. Then start ask
specific
This is a great post… and really does a great job of summarizing the
problems I have with the cassandra documentation.
I realize that Datastax is trying to step in and fix the problem.. but
there are now a lot of parties involved (JIRA tickets, blog posts, datastax
doc, apache doc, etc) … it's
On Wed, Jul 23, 2014 at 11:44 AM, Kevin Burton bur...@spinn3r.com wrote:
I have a lot of experience in distribute systems, understand the space
well, but I just can't find documentation on how cassandra does things from
a high level perspective.
My belief as to the reason why you are unable
: Wednesday, July 23, 2014 8:29 AM
To: user@cassandra.apache.org
Subject: Re: Why is the cassandra documentation such poor quality?
I think the problem is a little deeper than that. I've been working with
cassandra for about 7 months now - it was very challenging to find out any real
information about
This document:
https://wiki.apache.org/cassandra/Operations
… for example. Is extremely out dated… does NOT reflect 2.x releases
certainly. Mentions commands that are long since removed/deprecated.
Instead of giving bad documentation, maybe remove this and mark it as
obsolete.
The datastax
31 matches
Mail list logo