Mailing-List: contact dev-help@tajo.incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@tajo.incubator.apache.org
Received-SPF: pass (athena.apache.org: domain of ghoonson@gmail.com designates
 74.125.82.172 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAM=XDd-+7UawWW8YtKWV=B-VXTnUp9-8Z8MoXmppJgcEvdoKUA@mail.gmail.com>
References: 
 <CAM=XDd-+7UawWW8YtKWV=B-VXTnUp9-8Z8MoXmppJgcEvdoKUA@mail.gmail.com>
Date: Wed, 26 Feb 2014 15:39:37 +0900
Message-ID: 
 <CACZfFK6JwpNuQpUbTgMLer9P+T2Ozo0Gvk1M5cy0CGOKKqiPSw@mail.gmail.com>
Subject: Re: [Discussion] Tajo documentation
From: Jihoon Son <ghoonson@gmail.com>
To: "dev@tajo.incubator.apache.org" <dev@tajo.incubator.apache.org>
Content-Type: multipart/alternative; boundary=089e01494078fc1d9404f349771b

--089e01494078fc1d9404f349771b
Content-Type: text/plain; charset=ISO-8859-1

Sorry for late response.

I just take a quick look at the quick start and the tutorial,
but this tool seems to address all the problems which Hyunsik pointed out.

Thus, +1 and I agree with replacing our documentation tool with Sphinx.

Thanks,
Jihoon


2014-02-25 14:23 GMT+09:00 Hyunsik Choi <hyunsik@apache.org>:

> Hi folks,
>
> I would like to discuss the choice of documentation tool. Currently, we
> have used markdown and generated single page HTML document from the
> markdown via maven-site-plugin.
>
> I think that this approach has several problems as follows:
>   * a single page is very inconvenience to edit documents. I should have
> frequently scrolled a long page.
>   * The generated html from markdown page does not support table of
> contents. The table of contents in the current doc has been manually
> written by hand.
>   * It is hard to output multiple doc formats from single source.
>
> According to the characteristics of our project, we should maintain lots of
> documentations. I think that it is very important to choose the proper
> documentation tool before too late.
>
> I've found open source documentation tools for Tajo. I would like to
> propose using sphinx (http://sphinx-doc.org) for our documentation tool.
> It
> seems to meet our needs.
>
> If you know other nice doc tools, feel free to suggest.
>
> Best regards,
> Hyunsik Choi
>


-- 
Jihoon Son

Database & Information Systems Group,
Prof. Yon Dohn Chung Lab.
Dept. of Computer Science & Engineering,
Korea University
1, 5-ga, Anam-dong, Seongbuk-gu,
Seoul, 136-713, Republic of Korea

Tel : +82-2-3290-3580
E-mail : jihoonson@korea.ac.kr

--089e01494078fc1d9404f349771b--