[jbosstools-issues] [JBoss JIRA] (TOOLSDOC-310) bring back latest doc link

Nick Boldt (JIRA) jira-events at lists.jboss.org
Mon Apr 15 10:20:53 EDT 2013


    [ https://issues.jboss.org/browse/TOOLSDOC-310?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12767281#comment-12767281 ] 

Nick Boldt edited comment on TOOLSDOC-310 at 4/15/13 10:20 AM:
---------------------------------------------------------------

Why not just have http://docs.jboss.org/tools/latest/ point to http://www.jboss.org/tools/docs/reference, since that's where the latest docs actually live?

https://github.com/jbosstools/jbosstools-documentation/pull/50

[~maxandersen] Please note that to create symlinks on download.jboss.org (and presumably docs.jboss.org too), you have to create one *locally* to a *local* folder, then push the symlink to the server w/ rsync:

{code}
mkdir -p some/folder/to/link
rm -f latest
ln -s some/folder/to/link latest # use relative path, not absolute
rsync -Pzrlt --rsh=ssh --protocol=28 latest ${SERVER}:/tools/
{code}

If you create them during an SFTP connection to the server, the links will be *absolute file paths* which won't resolve on the web, rather than *relative paths* which are the same in the file structure AND on the web. I can point you to the servicedesk/eng-ops tickets about this if you need proof.
                
      was (Author: nickboldt):
    Why not just have http://docs.jboss.org/tools/latest/ point to http://www.jboss.org/tools/docs/reference, since that's where the latest docs actually live?

https://github.com/jbosstools/jbosstools-documentation/pull/50

                  
> bring back latest doc link
> --------------------------
>
>                 Key: TOOLSDOC-310
>                 URL: https://issues.jboss.org/browse/TOOLSDOC-310
>             Project: Documentation for JBoss Tools and Developer Studio
>          Issue Type: Feature Request
>      Security Level: Public(Everyone can see) 
>            Reporter: Max Rydahl Andersen
>            Assignee: Michelle Murray
>
> for some reason https://github.com/jbosstools/jbosstools-documentation/pull/48 removed the latest link assuming latest is used to point to the nightly build.
> That is not what it is for.
> It is to point to the latest docs made available.
> This link (before: http://docs.jboss.org/tools/latest/) was used to point to the last latest documentation.
> I believe this should be put back since this is how other docs refer to the latest version.
> We could even go so ar to create a docs.jboss.org/tools/4.0, docs.jboss.org/tools/3.3 etc. folder each with their /latest link in them.
> Latest links are trivial to make with sftp as part of the release upload anyway thus should be all possible to script if it is too cumbersome to remember.

--
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


More information about the jbosstools-issues mailing list