[
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
