You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cassandra.apache.org by aaron morton <aa...@thelastpickle.com> on 2011/10/06 13:29:51 UTC

wiki updates

With 1.0 almost here I was going to try and spruce up the wiki a bit to make things a little more welcoming for new users. 

I've created a copy of the home page here http://wiki.apache.org/cassandra/FrontPage_draft_aaron as a working draft. 

I've re-aranged things a little, and added some links to pages that do not yet exist. I was going to use it as a planning tool by working through all the pages linked there to see if they needed updated examples, or were yet to be written, that sort of thing. 

Thoughts ? 

I'll probably ask for some volunteers on the user list. 

Cheers

-----------------
Aaron Morton
Freelance Cassandra Developer
@aaronmorton
http://www.thelastpickle.com


Re: wiki updates

Posted by Nick Telford <ni...@gmail.com>.
This is a really good idea.

On first pass, I wonder if we should move the link to the Thrift API docs
out of the "Application Developers" block; CQL is the primary interface now
isn't it?

Following on from that, whenever pages include examples of read/write
queries (e.g. http://wiki.apache.org/cassandra/Counters) we should probably
replace those with the appropriate CQL wherever applicable.

Regards,
Nick Telford

On 6 October 2011 12:29, aaron morton <aa...@thelastpickle.com> wrote:

> With 1.0 almost here I was going to try and spruce up the wiki a bit to
> make things a little more welcoming for new users.
>
> I've created a copy of the home page here
> http://wiki.apache.org/cassandra/FrontPage_draft_aaron as a working draft.
>
> I've re-aranged things a little, and added some links to pages that do not
> yet exist. I was going to use it as a planning tool by working through all
> the pages linked there to see if they needed updated examples, or were yet
> to be written, that sort of thing.
>
> Thoughts ?
>
> I'll probably ask for some volunteers on the user list.
>
> Cheers
>
> -----------------
> Aaron Morton
> Freelance Cassandra Developer
> @aaronmorton
> http://www.thelastpickle.com
>
>

Re: wiki updates

Posted by Eric Evans <ee...@acunu.com>.
On Thu, Oct 6, 2011 at 6:29 AM, aaron morton <aa...@thelastpickle.com> wrote:
> With 1.0 almost here I was going to try and spruce up the wiki a bit to make things a little more welcoming for new users.
>
> I've created a copy of the home page here http://wiki.apache.org/cassandra/FrontPage_draft_aaron as a working draft.

Awesome.  Thanks for leading this Aaron.

-- 
Eric Evans
Acunu | http://www.acunu.com | @acunu

Re: wiki updates

Posted by aaron morton <aa...@thelastpickle.com>.
Ok, I'll go ahead and work out a way for people to contribute.

@Nick, yes to include CQL examples, and to give them first, but I would also keep the rpc call for now. As the RPC interface is still officially supported. 

@Yang, Happy to re-arrange things once we have some content. For better or worse I used the Hive wiki as guide https://cwiki.apache.org/confluence/display/Hive/Home  . Creating new content takes time, first I'd like to improve what we have and make sure it is correct. 


Thanks

-----------------
Aaron Morton
Freelance Cassandra Developer
@aaronmorton
http://www.thelastpickle.com

On 7/10/2011, at 1:24 AM, Yi Yang wrote:

> Thanks Aaron for the hard work.   The new front page gives a much clear
> image on Cassandra.
> 
> However I would also like to present some of my thoughts - based on my own
> learning path:
> 
> 1) The first part should present a clear image on what Cassandra is, and
> what's inside Cassandra - thus we'd better include the Data Model section in
> it - people will easily get to know what's the difference between Cassandra
> and other key based databases like HBase, MangoDB etc., therefore make wise
> choices.
> 
> 2) The second part could give a glance at how to make Cassandra running on a
> small to moderate level application - aka the a small development platform.
>  Including how to create a cluster and also running on Windows / Amazon
> EC2. Here StorageConfiguration is not so important because the target of
> this section is to help users build up a usable Cassandra Cluster.
> 
> 3) The third part can help the administrators of large scale application,
> and also introducing management strategies like storage configuration and
> also other monitoring, node operations techniques.
> 
> The rest parts are perfect. I hope we can match the list with a typical
> users' learning experience, so that for users at different level they can
> focus on their own section. It's just my own idea - and it might different
> from others' experiences, hopefully it could help. Thanks again for the
> great work.
> 
> Best,
> Yi
> 
> On Thu, Oct 6, 2011 at 7:29 PM, aaron morton <aa...@thelastpickle.com>wrote:
> 
>> With 1.0 almost here I was going to try and spruce up the wiki a bit to
>> make things a little more welcoming for new users.
>> 
>> I've created a copy of the home page here
>> http://wiki.apache.org/cassandra/FrontPage_draft_aaron as a working draft.
>> 
>> I've re-aranged things a little, and added some links to pages that do not
>> yet exist. I was going to use it as a planning tool by working through all
>> the pages linked there to see if they needed updated examples, or were yet
>> to be written, that sort of thing.
>> 
>> Thoughts ?
>> 
>> I'll probably ask for some volunteers on the user list.
>> 
>> Cheers
>> 
>> -----------------
>> Aaron Morton
>> Freelance Cassandra Developer
>> @aaronmorton
>> http://www.thelastpickle.com
>> 
>> 


Re: wiki updates

Posted by Yi Yang <i...@iyyang.com>.
Thanks Aaron for the hard work.   The new front page gives a much clear
image on Cassandra.

However I would also like to present some of my thoughts - based on my own
learning path:

1) The first part should present a clear image on what Cassandra is, and
what's inside Cassandra - thus we'd better include the Data Model section in
it - people will easily get to know what's the difference between Cassandra
and other key based databases like HBase, MangoDB etc., therefore make wise
choices.

2) The second part could give a glance at how to make Cassandra running on a
small to moderate level application - aka the a small development platform.
  Including how to create a cluster and also running on Windows / Amazon
EC2. Here StorageConfiguration is not so important because the target of
this section is to help users build up a usable Cassandra Cluster.

3) The third part can help the administrators of large scale application,
and also introducing management strategies like storage configuration and
also other monitoring, node operations techniques.

The rest parts are perfect. I hope we can match the list with a typical
users' learning experience, so that for users at different level they can
focus on their own section. It's just my own idea - and it might different
from others' experiences, hopefully it could help. Thanks again for the
great work.

Best,
Yi

On Thu, Oct 6, 2011 at 7:29 PM, aaron morton <aa...@thelastpickle.com>wrote:

> With 1.0 almost here I was going to try and spruce up the wiki a bit to
> make things a little more welcoming for new users.
>
> I've created a copy of the home page here
> http://wiki.apache.org/cassandra/FrontPage_draft_aaron as a working draft.
>
> I've re-aranged things a little, and added some links to pages that do not
> yet exist. I was going to use it as a planning tool by working through all
> the pages linked there to see if they needed updated examples, or were yet
> to be written, that sort of thing.
>
> Thoughts ?
>
> I'll probably ask for some volunteers on the user list.
>
> Cheers
>
> -----------------
> Aaron Morton
> Freelance Cassandra Developer
> @aaronmorton
> http://www.thelastpickle.com
>
>