From odf-dev-return-23-apmail-incubator-odf-dev-archive=incubator.apache.org@incubator.apache.org Tue Aug 16 20:55:48 2011 Return-Path: X-Original-To: apmail-incubator-odf-dev-archive@minotaur.apache.org Delivered-To: apmail-incubator-odf-dev-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id AFF57879B for ; Tue, 16 Aug 2011 20:55:48 +0000 (UTC) Received: (qmail 50387 invoked by uid 500); 16 Aug 2011 20:55:48 -0000 Delivered-To: apmail-incubator-odf-dev-archive@incubator.apache.org Received: (qmail 50357 invoked by uid 500); 16 Aug 2011 20:55:48 -0000 Mailing-List: contact odf-dev-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: odf-dev@incubator.apache.org Delivered-To: mailing list odf-dev@incubator.apache.org Received: (qmail 50349 invoked by uid 99); 16 Aug 2011 20:55:48 -0000 Received: from minotaur.apache.org (HELO minotaur.apache.org) (140.211.11.9) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 16 Aug 2011 20:55:48 +0000 Received: from localhost (HELO mail-iy0-f169.google.com) (127.0.0.1) (smtp-auth username robweir, mechanism plain) by minotaur.apache.org (qpsmtpd/0.29) with ESMTP; Tue, 16 Aug 2011 20:55:47 +0000 Received: by iym1 with SMTP id 1so503698iym.0 for ; Tue, 16 Aug 2011 13:55:47 -0700 (PDT) MIME-Version: 1.0 Received: by 10.231.45.204 with SMTP id g12mr275378ibf.79.1313528146997; Tue, 16 Aug 2011 13:55:46 -0700 (PDT) Received: by 10.42.220.135 with HTTP; Tue, 16 Aug 2011 13:55:46 -0700 (PDT) In-Reply-To: References: Date: Tue, 16 Aug 2011 16:55:46 -0400 Message-ID: Subject: Re: ODF Toolkit: Existing Infrastructure From: Rob Weir To: odf-dev@incubator.apache.org Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On Tue, Aug 16, 2011 at 4:44 PM, Ansgar Konermann wrote: > Am 16.08.2011 17:37 schrieb "Rob Weir" : >> >> On Mon, Aug 15, 2011 at 6:41 PM, Nick Burch > wrote: >> > On Mon, 15 Aug 2011, Rob Weir wrote: >> >> >> >> 1) =C2=A0a wiki (no idea what application this is underneath -- might= be >> >> specific to Kenai) >> > >> > Do you know what syntax it supports? If you can get a page listing the >> > syntax, I'd suggest comparing it against the confluence one, the > moinmoin >> > one, and markdown >> > >> >> Syntax is here: > http://odftoolkit.org/projects/help/pages/Wikis#Wiki_Formatting >> >> Looks like this is MediaWiki. >> >> >> 6) A Mercurial repository >> > >> > This will need to be switched to SVN, with an read only git repo > available >> > too. No reason why people can't use the hg svn integration to keep > working > >> > on hg locally if they want to, but SVN will need to be the canonical > store > > Apache announced initial support for git a week ago or so, at least for b= eta > usage. As git is very similar to hg (dvcs), we should really push ASF to > allow odf toolkit to pilot git usage. I'm convinced a dvcs will facilitat= e > contributing to odftoolkit a lot, so please let's at least *try* to get a > dvcs right from the start. > Where did you see this announcement? > I know two of my co workers have a number of patches ready for contributi= on > to simple api, but going back to svn will likely distract them. > >> > >> >> Right. =C2=A0Ideally we want to preserve history. =C2=A0I'm not sure wha= t is >> possible here. =C2=A0This will require some experiments with Hg -> Svn >> conversions. =C2=A0This can be done locally until we have a dump file fo= r >> Svn we can hand off to Apache Infra. >> >> > >> >> ODFDOM and the Conformance tools use the wiki has its primary home >> >> page. =C2=A0 Simple JavaAPI uses the wiki for release notes, but has = a >> >> separate main home page. >> > >> > I'd suggest we try to convert the bulk of these into regular markdown > pages. >> > Switching the wiki syntax should be pretty easy. >> > >> >> Wiki pages probably migrate easily. =C2=A0Not so sure of the Simple API >> pages, which may require more formatting control that markdown offers: >> >> http://simple.odftoolkit.org/ >> >> I know something about the Apache CMS and markdown from the Apache >> OpenOffice project. =C2=A0But for those who are not familiar it, we have >> the option of maintaining our website using text files in "markdown" >> syntax.[1]. =C2=A0This is simpler than HTML, more like wiki text. =C2=A0= But you >> can drop down into HTML when needed, and the styling is done via CSS. >> >> The markdown files are stored in SVN and can be checked out and edited >> and committed like any other file. =C2=A0But Apache also has a web-based >> system where you can edit the markdown pages in your browser, with a >> WYSIWYG preview. =C2=A0This makes it very easy for any project committer= to >> edit the web pages. >> >> More information here [2], this is also an example of a page created >> in markdown. >> >> >> [1] http://daringfireball.net/projects/markdown/syntax >> [2] http://incubator.apache.org/openofficeorg/docs/edit-cms.html >> >> >> > Wikis are best for things that non committers may wish to help with, f= or > the >> > official docs it's probably best to put it in the CMS >> > >> >> ODFDOM and the Conformance tools doe not have user forums. =C2=A0 Sim= ple >> >> API does, but they are not really used. =C2=A0The user mailing list i= s >> >> where the main engagement with users occurs. >> > >> > OK, I'd suggest we try to close it to make things easier >> > >> >> There are around 400 total issues in Bugzilla (in all states) and >> >> maybe 40 wiki pages. >> > >> > Do you know which version of bugzilla, and if a dump is possible? >> > >> >> It is Bugzilla 3.2.10. =C2=A0I don't have permissions to create a dump. >> Svante? =C2=A0Daisy? =C2=A0It is possible we'll need to put in a request= with >> the Kenai admins at Oracle for this. >> >> > >> >> I'd like to see if we can try to think of this as a single project, >> >> with a single home page (of course, with detailed pages for each >> >> component), with a user user list, single dev list, single repository= , >> >> etc. >> > >> > That would make sense to me. If we find a lot of traffic on the user > list, >> > we can always split it later into the sub-projects. To start with it's >> > probably best to have one list to help build the community >> > >> >> The amount of content is not very much. =C2=A0So worst case, we could > migrate >> >> the wiki with cut & paste. >> > >> > A small perl script can usually help with translating the syntax :) >> > >> >> I'm faster with cut & paste than with perl. =C2=A0But python is another > story... >> >> > Nick >> > >