[
https://issues.apache.org/jira/browse/HADOOP-4105?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12634218#action_12634218
]
Doug Cutting commented on HADOOP-4105:
--------------------------------------
This could still go into 0.19: documentation patches are accepted (encouraged
even) after the branch. It would be great to have.
Some comments:
- there's non-code text inside source tags
- the example isn't a complete, compileable file
- absolute links to headers in trunk and the javadoc on the website should not
be included in versioned documentation. rather these should be relative to the
release packaging. there are lots of examples of links to javadocs in other
documentation pages. to link to the header could be tricky and might best be
just be some text saying to look in 'src/c++/libhdfs'. to check your relative
links, use 'ant package', then browse build/hadoop-xxx'.
- the included compilation instructions should be for compiling the example,
not for building libhdfs. libhdfs should be pre-built in releases. this
documentation is for users of libhdfs, not developers of it.
> libhdfs wiki is very out-of-date and contains mostly broken links
> -----------------------------------------------------------------
>
> Key: HADOOP-4105
> URL: https://issues.apache.org/jira/browse/HADOOP-4105
> Project: Hadoop Core
> Issue Type: Task
> Components: documentation, libhdfs
> Reporter: Pete Wyckoff
> Assignee: Pete Wyckoff
> Priority: Minor
> Fix For: 0.20.0
>
> Attachments: HADOOP-4105.1.txt
>
>
> This thing is way out of date and seems incorrect in some places. Also note
> it is not linked from the wiki front page.
> http://wiki.apache.org/hadoop/LibHDFS
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
