Mailing-List: contact common-issues-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
Reply-To: common-issues@hadoop.apache.org
Date: Tue, 23 Oct 2012 19:23:14 +0000 (UTC)
From: "Andy Isaacson (JIRA)" <jira@apache.org>
To: common-issues@hadoop.apache.org
Message-ID: <893897798.17574.1351020194361.JavaMail.jiratomcat@arcas>
In-Reply-To: <1466513464.12304.1337794182463.JavaMail.jiratomcat@issues-vm>
Subject: [jira] [Commented] (HADOOP-8427) Convert Forrest docs to APT
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/HADOOP-8427?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13482599#comment-13482599 ] 

Andy Isaacson commented on HADOOP-8427:
---------------------------------------

bq. There are two problems (1) converting the format to API and (2) removing the out-dated doc. (1) changes the entire file but (2) only removes some lines for the file.

I think you're suggesting that (1) be a completely mechanical conversion to APT with no editing, so that the rendered document should be word-for-word identical, right?

I can certainly do that.  That means doing a fair amount of work on documents that will immediately be deleted because they are out of date, but I agree that a mechanical change is easiest to validate.
                
> Convert Forrest docs to APT
> ---------------------------
>
>                 Key: HADOOP-8427
>                 URL: https://issues.apache.org/jira/browse/HADOOP-8427
>             Project: Hadoop Common
>          Issue Type: Task
>          Components: documentation
>    Affects Versions: 2.0.0-alpha
>            Reporter: Eli Collins
>            Assignee: Andy Isaacson
>              Labels: newbie
>         Attachments: hadoop8427-1.txt, hadoop8427.txt
>
>
> Some of the forrest docs content in src/docs/src/documentation/content/xdocs has not yet been converted to APT and moved to src/site/apt. Let's convert the forrest docs that haven't been converted yet to new APT content in hadoop-common/src/site/apt (and link the new content into hadoop-project/src/site/apt/index.apt.vm) and remove all forrest dependencies.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira