I prefer wiki than markdown. To make it less messy, it will be helpful for each wiki page to have an "owner" who can make sure the page is always up to date, and changes to the page are reviewed.
@Till: my new Confluence id is: "chenlcia". Chen On Sat, Aug 8, 2015 at 8:44 AM, Till Westmann <[email protected]> wrote: > Thanks! > > For everybody else: if you want to write something on the Wiki, please > register at https://cwiki.apache.org/confluence/signup.action > <https://cwiki.apache.org/confluence/signup.action> and send out your user > name so that we can add it to our Wiki space. > > Cheers, > Till > >> On Aug 8, 2015, at 7:34 AM, Jianfeng Jia <[email protected]> wrote: >> >> Done. >> >> On Sat, Aug 8, 2015 at 1:43 AM, Till Westmann <[email protected]> wrote: >> >>> Ok, we got the Wiki: >>> https://cwiki.apache.org/confluence/display/ASTERIXDB/Asterix+DB >>> But I’m not an administrator - but Jianfeng is. >>> >>> @Jianfeng, could you add me (tillw) as an administrator? >>> >>> Thanks, >>> Till >>> >>>> On Aug 8, 2015, at 1:06 AM, Jianfeng Jia <[email protected]> wrote: >>>> >>>> Hi Till, >>>> My username is Jianfeng >>>> >>>> On Sat, Aug 8, 2015 at 12:53 AM, Till Westmann <[email protected]> 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 <[email protected]> >>> 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 < >>> [email protected]> >>>>>>>> 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 <[email protected]> >>>>>>>>> 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 < >>>>>>>>>>> [email protected] >>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> 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 >>>>>>>> >>>>>>>> >>>>>>> >>>> >>>> >>>> -- >>>> >>>> ----------------- >>>> Best Regards >>>> >>>> Jianfeng Jia >>>> Ph.D. Candidate of Computer Science >>>> University of California, Irvine >>> >>> >> >> >> -- >> >> ----------------- >> Best Regards >> >> Jianfeng Jia >> Ph.D. Candidate of Computer Science >> University of California, Irvine >
