[
https://issues.apache.org/jira/browse/HDFS-4460?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13568416#comment-13568416
]
Andy Isaacson commented on HDFS-4460:
-------------------------------------
bq. after staging I just go to the link at staging/hadoop-project/index.html -
which is similar page as http://hadoop.apache.org/docs/current/.
When I visit file:///tmp/hadoop-site/hadoop-project/index.html I get a fair
number of links in the left navigation bar.
The navigation bar links to the following: {{BuildingIt CLIMiniCluster
CapacityScheduler ClusterSetup CommandsManual Configuration
DeprecatedProperties EncryptedShuffle Examples Federation FileSystemShell
HDFSHighAvailabilityWithNFS HDFSHighAvailabilityWithQJM HistoryServerRest
MapredAppMasterRest NodeManagerRest ResourceManagerRest SingleCluster
WebApplicationProxy WebHDFS WebServicesIntro WritingYarnApplications YARN
YarnCommands}}
The following {{.apt.vm}} files in the tree are not linked in the navigation
bar:
{noformat}
hadoop-common-project/hadoop-common/src/site/apt/HttpAuthentication.apt.vm
hadoop-common-project/hadoop-common/src/site/apt/NativeLibraries.apt.vm
hadoop-common-project/hadoop-common/src/site/apt/ServiceLevelAuth.apt.vm
hadoop-common-project/hadoop-common/src/site/apt/SingleNodeSetup.apt.vm
hadoop-common-project/hadoop-common/src/site/apt/Superusers.apt.vm
hadoop-hdfs-project/hadoop-hdfs-httpfs/src/site/apt/ServerSetup.apt.vm
hadoop-hdfs-project/hadoop-hdfs-httpfs/src/site/apt/UsingHttpTools.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/FaultInjectFramework.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsDesign.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsEditsViewer.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsImageViewer.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsPermissionsGuide.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsQuotaAdminGuide.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsUserGuide.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/Hftp.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/LibHdfs.apt.vm
hadoop-hdfs-project/hadoop-hdfs/src/site/apt/SLGUserGuide.apt.vm
hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/apt/FairScheduler.apt.vm
{noformat}
At a quick glance I'm inclined to add links to the following: {{FairScheduler
HdfsDesign HdfsEditsViewer HdfsImageViewer HdfsPermissionsGuide
HdfsQuotaAdminGuide HdfsUserGuide Hftp HttpAuthentication LibHdfs
NativeLibraries ServerSetup Superusers UsingHttpTools}}
and leave the following unlinked: {{FaultInjectFramework SLGUserGuide
ServiceLevelAuth SingleNodeSetup}}
> HDFS docs not linked from top level
> -----------------------------------
>
> Key: HDFS-4460
> URL: https://issues.apache.org/jira/browse/HDFS-4460
> Project: Hadoop HDFS
> Issue Type: Bug
> Components: documentation
> Affects Versions: 3.0.0, 2.0.3-alpha, 0.23.7
> Reporter: Thomas Graves
> Assignee: Andy Isaacson
> Attachments: hdfs4460.txt
>
>
> HADOOP-9221 and others converted docs to apt format. After that they aren't
> linked to the top level menu like: http://hadoop.apache.org/docs/current/
> I only see the hadoop commands manual and the Filesystem shell. It used to be
> you clicked on say the commands manual and you would go to the old style
> documentation where it had a menu with links to the Superusers, native
> libraries, etc, but I don't see that any more since converted.
--
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
