cassandra-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Benedict Elliott Smith <belliottsm...@datastax.com>
Subject Re: Why is the cassandra documentation such poor quality?
Date Wed, 23 Jul 2014 11:40:36 GMT
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 the dev list also.


On Wed, Jul 23, 2014 at 1:33 PM, Peter Lin <woolfel@gmail.com> wrote:

>
> 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