hadoop-common-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andy Isaacson (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HADOOP-8427) Convert Forrest docs to APT
Date Tue, 23 Oct 2012 19:23:14 GMT

    [ 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

Mime
View raw message