cassandra-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Peter Lin <wool...@gmail.com>
Subject Re: Why is the cassandra documentation such poor quality?
Date Wed, 23 Jul 2014 11:33:45 GMT
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 ask them to
update it feels silly to me and kind of goes against openness. Back when I
was active with JMeter, we decided to leave it open so that anyone can edit
the docs.

I can't be the only one that wants to help make the docs better, but get
frustrated with the wiki being closed.



On Wed, Jul 23, 2014 at 4:25 AM, <spawgi@gmail.com> wrote:

> 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 <snazy@snazy.de> wrote:
>
>> Just a note:
>> If you have suggestions how to improve documentation on the datastax
>> website, write them an email to docs@datastax.com. They appreciate
>> proposals :)
>>
>> Am 23.07.2014 um 09:10 schrieb Mark Reddy <mark.reddy@boxever.com>:
>>
>> 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 Apache site has dwindled. However, if you are
>> interested in contributing to it and bringing it back up to standard you
>> can, thus is the freedom of open source.
>>
>>
>> Mark
>>
>>
>> On Wed, Jul 23, 2014 at 2:54 AM, Kevin Burton <burton@spinn3r.com> wrote:
>>
>>> 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 documentation… is … acceptable I guess.  My main criticism
>>> there is that a lot of it it is in their blog.
>>>
>>> Kevin
>>>
>>> --
>>>
>>> Founder/CEO Spinn3r.com <http://spinn3r.com/>
>>> Location: *San Francisco, CA*
>>> blog: http://burtonator.wordpress.com
>>> … or check out my Google+ profile
>>> <https://plus.google.com/102718274791889610666/posts>
>>> <http://spinn3r.com/>
>>>
>>>
>>
>>
>
>
> --
> http://spawgi.wordpress.com
> We can do it and do it better.
>

Mime
View raw message