[jbosstools-issues] [JBoss JIRA] (TOOLSDOC-310) redirect /latest to /reference where the latest released docs can be found

Max Rydahl Andersen (JIRA) jira-events at lists.jboss.org
Fri Apr 19 04:02:57 EDT 2013


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

Max Rydahl Andersen commented on TOOLSDOC-310:
----------------------------------------------

The links on https://www.jboss.org/tools/docs/reference/ still seem to use exact specific versions (i.e. http://docs.jboss.org/tools/4.0.1.Final/) instead of a "latest" link to http://docs.jboss.org/tools/4.0.x/ ? 

Meaning if/when we do an update of the docs we still need to update the magnolia page.

Thus i'm missing where the symbolic links are setup.

And wouldn't it be better to create a structure like:

3.3/latest
3.3/3.3.0.Final
4.0/4.0.1.Final
4.0/4.0.0.Final
4.0/latest -> 4.0.0.Final

which removes all need for moving things to archive ?  (could also just have it in one big root directory....my main concern is just not having to move things around over time; once url is used it stays.

btw. I noticed you said symbolic links result in absolute paths - that should not happen if done via sftp like seam and richfaces guys do it:

http://www.seamframework.org/Seam3/ModuleReleaseProcedure
sftp seam at filemgmt.jboss.org
sftp> cd docs_htdocs/seam/3/{module}
sftp> rm latest
sftp> ln 3.0.m.Q latest

                
> redirect /latest to /reference where the latest released docs can be found
> --------------------------------------------------------------------------
>
>                 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: Nick Boldt
>
> 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