Mailing-List: contact dev-help@asterixdb.incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@asterixdb.incubator.apache.org
MIME-Version: 1.0
In-Reply-To: <EED66501-0D42-4892-AD00-39036D383EF8@apache.org>
References: 
 <CAOQkTyPeG16fA+t_9VPiwbm763yOBrK9OESEe=Hr5ixRMbK_AQ@mail.gmail.com>
 <CAJ6yC3a6MZ=yBis3k0cEsn-ag9RXnSj3LtH8aK_3r743tW9b2w@mail.gmail.com>
 <B307D5DD-A323-41D1-877A-8FD9843AE4F6@apache.org>
 <CAOQkTyMBPaOW4bP7bFFN2wfsZ0Mihescg-MiAUCjUkOy3qCh2A@mail.gmail.com>
 <CAJ6yC3bH02=EvvbXo_RxP0N+Z8EWHO_SK7W04g3qeO7WQR=jAQ@mail.gmail.com>
 <829C0C81-E815-4276-912B-D8D8E2A95BEC@apache.org>
 <CAJwFCa2ffBuABVqG02-H-TE1hY=LaxgrCcm9gO3AbYvo019xUQ@mail.gmail.com>
 <EED66501-0D42-4892-AD00-39036D383EF8@apache.org>
From: Ted Dunning <ted.dunning@gmail.com>
Date: Sat, 8 Aug 2015 01:31:33 -0700
Message-ID: 
 <CAJwFCa1nOBqpuMdS0brXXYfyxHkc=9MvZ8xv3_KkQtHz10caww@mail.gmail.com>
Subject: Re: Point3: Growing the community
To: dev@asterixdb.incubator.apache.org
Content-Type: multipart/alternative; boundary=001a1137a44833cc0e051cc896bd

--001a1137a44833cc0e051cc896bd
Content-Type: text/plain; charset=UTF-8

They might well work for that.


On Sat, Aug 8, 2015 at 12:53 AM, Till Westmann <tillw@apache.org> wrote:

> In general I'm also not a big fan of Wikis as they tend to get messy after
> a while.
> So I wouldn't necessarily use them for documentation. But I think that
> there's a place for them for quick collaboration.
> Do you think that the Apache Wikis (confluence in this case) would be
> suited for that or would that be cumbersome as well?
>
> On 8 Aug 2015, at 0:46, Ted Dunning wrote:
>
> Be cautious a bit here.  The wikis that are available at Apache tend to be
>> a bit cumbersome.
>>
>> Some projects have lately opted to simply storing pages as mark-down which
>> are automatically rendered.  This makes it easy to make updates and even
>> have outsiders contributed, but not as easy as a wiki.  On the other hand,
>> it is more reliable and serves pages very fast.
>>
>>
>>
>>
>> On Sat, Aug 8, 2015 at 12:33 AM, Till Westmann <tillw@apache.org> wrote:
>>
>> I've created a request (
>>> https://issues.apache.org/jira/servicedesk/agent/INFRA/issue/INFRA-10090
>>> ),
>>> hopefully the information I provided is sufficient.
>>>
>>> Cheers,
>>> Till
>>>
>>>
>>> On 8 Aug 2015, at 0:11, Jianfeng Jia wrote:
>>>
>>> +1 for wiki!
>>>
>>>>
>>>> On Sat, Aug 8, 2015 at 12:09 AM, abdullah alamoudi <bamousaa@gmail.com>
>>>> wrote:
>>>>
>>>> I agree with both of you. This is not a single man job :-)
>>>>
>>>>>
>>>>> On Sat, Aug 8, 2015 at 10:06 AM, Till Westmann <tillw@apache.org>
>>>>> wrote:
>>>>>
>>>>> We don't have a wiki yet, but it should be easy to get one (and it's
>>>>>
>>>>>> probably the right tool to do something like this).
>>>>>> Would you agree?
>>>>>>
>>>>>> Cheers,
>>>>>> Till
>>>>>>
>>>>>> On 7 Aug 2015, at 23:59, Jianfeng Jia wrote:
>>>>>>
>>>>>> Do you guys like the Wiki? like the Spark's:
>>>>>>
>>>>>>
>>>>>>> https://cwiki.apache.org/confluence/display/SPARK/Contributing+to+Spark
>>>>>>>
>>>>>>> .
>>>>>>
>>>>>
>>>>>
>>>>>> We can create a skeleton, create different pages for different
>>>>>>> internal
>>>>>>> components, and *gradually* fill it. (It's a history debt that I
>>>>>>> don't
>>>>>>> think some guy can spend just some days to finish it perfectly. Let's
>>>>>>> crowdsource it. :-)
>>>>>>>
>>>>>>>
>>>>>>> On Fri, Aug 7, 2015 at 11:04 PM, abdullah alamoudi <
>>>>>>> bamousaa@gmail.com
>>>>>>>
>>>>>>>>
>>>>>>>> wrote:
>>>>>>>
>>>>>>> Hi everyone,
>>>>>>>
>>>>>>> In the August 2015 incubator report, the 3rd issue to address before
>>>>>>>> graduation is growing the AsterixDB community.
>>>>>>>>
>>>>>>>> Since we entered the incubator, at least two members wanted to join
>>>>>>>> the
>>>>>>>> community and contribute only to end up disappearing. Getting
>>>>>>>>
>>>>>>>> acquainted
>>>>>>>
>>>>>>
>>>>> with the codebase seems like a difficult task for new comers and I
>>>>>>
>>>>>>>
>>>>>>>> think
>>>>>>>
>>>>>>
>>>>> we
>>>>>>
>>>>>>> should make it a little bit easier.
>>>>>>>>
>>>>>>>> I know this is long overdue and someone promised in the ancient past
>>>>>>>> to
>>>>>>>> prepare an entry document for new contributor (Who was it?). I am
>>>>>>>> aware
>>>>>>>> that we all are busy addressing issues, working on new features,
>>>>>>>>
>>>>>>>> running
>>>>>>>
>>>>>>
>>>>> some experiments, writing a paper, etc. but we can still work towards
>>>>>>
>>>>>>> this
>>>>>>>> in small steps.
>>>>>>>>
>>>>>>>> My suggestion is that someone create an outline of how that document
>>>>>>>>
>>>>>>>> will
>>>>>>>
>>>>>>
>>>>> be and then publish it in some location where we all have a chance to
>>>>>>
>>>>>>> contribute (Maybe the AsterixDB website in the documentation
>>>>>>>> branch?).
>>>>>>>> Once
>>>>>>>> we have that, whenever somebody spends some time in a new area of
>>>>>>>> the
>>>>>>>> code,
>>>>>>>> they should contribute to the document and we should eventually get
>>>>>>>> there.
>>>>>>>>
>>>>>>>>
>>>>>>>> Cheers,
>>>>>>>> Amoudi, Abdullah.
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>> --
>>>>>>>
>>>>>>> -----------------
>>>>>>> Best Regards
>>>>>>>
>>>>>>> Jianfeng Jia
>>>>>>> Ph.D. Candidate of Computer Science
>>>>>>> University of California, Irvine
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>
>>>>> --
>>>>> Amoudi, Abdullah.
>>>>>
>>>>>
>>>>>
>>>>
>>>> --
>>>>
>>>> -----------------
>>>> Best Regards
>>>>
>>>> Jianfeng Jia
>>>> Ph.D. Candidate of Computer Science
>>>> University of California, Irvine
>>>>
>>>>
>>>

--001a1137a44833cc0e051cc896bd--