From user-return-9166-apmail-couchdb-user-archive=couchdb.apache.org@couchdb.apache.org Fri Mar 05 20:08:46 2010 Return-Path: Delivered-To: apmail-couchdb-user-archive@www.apache.org Received: (qmail 52147 invoked from network); 5 Mar 2010 20:08:46 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 5 Mar 2010 20:08:46 -0000 Received: (qmail 38823 invoked by uid 500); 5 Mar 2010 20:08:30 -0000 Delivered-To: apmail-couchdb-user-archive@couchdb.apache.org Received: (qmail 38724 invoked by uid 500); 5 Mar 2010 20:08:30 -0000 Mailing-List: contact user-help@couchdb.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: user@couchdb.apache.org Delivered-To: mailing list user@couchdb.apache.org Received: (qmail 38708 invoked by uid 99); 5 Mar 2010 20:08:30 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 05 Mar 2010 20:08:30 +0000 X-ASF-Spam-Status: No, hits=0.7 required=10.0 tests=RCVD_IN_DNSWL_NONE,SPF_NEUTRAL X-Spam-Check-By: apache.org Received-SPF: neutral (athena.apache.org: local policy) Received: from [209.85.218.220] (HELO mail-bw0-f220.google.com) (209.85.218.220) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 05 Mar 2010 20:08:29 +0000 Received: by bwz20 with SMTP id 20so437291bwz.32 for ; Fri, 05 Mar 2010 12:08:07 -0800 (PST) Received: by 10.204.138.71 with SMTP id z7mr558186bkt.77.1267819687302; Fri, 05 Mar 2010 12:08:07 -0800 (PST) Received: from [192.168.0.4] (5ad6a7ad.bb.sky.com [90.214.167.173]) by mx.google.com with ESMTPS id g18sm2448765bkw.1.2010.03.05.12.08.05 (version=TLSv1/SSLv3 cipher=RC4-MD5); Fri, 05 Mar 2010 12:08:06 -0800 (PST) Subject: Re: CouchDB Wiki / Documentation Mime-Version: 1.0 (Apple Message framework v1077) Content-Type: text/plain; charset=us-ascii From: Noah Slater In-Reply-To: <0059D58E-A388-4B7A-B767-7E62154A1753@googlemail.com> X-Noah: Awesome Date: Fri, 5 Mar 2010 20:08:02 +0000 Cc: dev@couchdb.apache.org Content-Transfer-Encoding: quoted-printable Message-Id: <3B7C8CB9-727E-4566-8A38-EA19419AF988@tumbolia.org> References: <0059D58E-A388-4B7A-B767-7E62154A1753@googlemail.com> To: user@couchdb.apache.org X-Mailer: Apple Mail (2.1077) This should be on dev@ I think, so moving there. Please remove user@ from the address in your replies to this message. On 5 Mar 2010, at 19:36, Sebastian Cohnen wrote: > but back to topic: MoinMoin sucks! It's unbelievably slow, throws 500s = all the time and don't forget the syntax - pure hell when you seriously = want to work with it. I've talked with Jan and he has been recently = thinking of a replacement. =46rom an old blog post: We were discussing Apache infrastructure, and I was joking about how = much I hated JIRA. Robert Newson suggested that having to pick between = JIRA and Bugzilla was Hobson's choice, but I countered with Sophie's = choice, and his riposte was Morton's fork. When we were cautioned to = avoid Buridan's ass, I commented "that's what she said!" > As a first step we want to suggest using Markdown Just use HTML, it is way simpler. > and git from now on - at least for documentation purposes > Once we (or better I) have enough translated from MoinMoin to Markdown = we could start linking from the wiki to Github (as it renders markdown = nicely for you). Nice idea, but absolutely not. Official project documentation should be on couchdb.apache.org and the = wiki must be on apache infrastructure. Unofficial stuff, like our = O'Reilly book, is fine elsewhere, but that's all it can be - as far as I = understand the situation. > We think that this approach is likely to work best as an interim = solution before we have a ass-kickin' couch-wiki solution. Once that's = done, we can easily import the markdown stuff. or maybe markdown+git = works so well, so that it stays the preferred way - who knows? ;) Avoid Markdown! It solves nothing and introduces problems. > This is only a suggestion and we really want your opinion. I think the = rudimental requirements are quite clear: > * a faster and more reliable system > * very easy to contribute > * easy and easy to learn syntax > * being able to work offline (at least for me that would be awesome) > * easy way to do some QA Whatever we choose must run on ASF infrastructure if it is to be = considered official.