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

Nick Boldt (JIRA) jira-events at lists.jboss.org
Thu Apr 18 01:01:11 EDT 2013


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

Nick Boldt commented on TOOLSDOC-310:
-------------------------------------

New kick at the can for https://www.jboss.org/tools/docs/reference/ : 

!http://snag.gy/XioYn.jpg!

Changes include: 

* remove all links to content which is actually located on docs.jboss.org
* add links to Additional documentation and Archived documentation

---

And for http://docs.jboss.org/tools/ :

!http://snag.gy/rVRnb.jpg!

Changes include:

* stuff in OLD/ moved to archive/, then symlinked back
* milestone docs in OLD/ moved to archive/milestones/

* links to 3.x docs (except for 3.3.0, the last one) removed from index page 
* 3.3.0.Final doc zip moved into archive/

* index page in resources/ removed as it was inaccurate (wrong dates, wrong file sizes, missing links); generated index is 100% accurate
* experimental vpe_xulrunner zip renamed and moved into resources/; README updated to clarify that this is from JBT 2.0, from 2007, and is UNSUPPORTED.

* link for movies relabelled as "Movies, Screencasts, and Video Walkthroughs"
* fixed link to archived movies in http://docs.jboss.org/tools/archive/movies/

* fixed updated date to be ISO compliant
* "nightly" watermark removed from index page
* added new links to http://www.jboss.org/tools/docs/ and http://www.jboss.org/tools/
* latest/ is now a symlink to 4.0.1.Final instead of an index.html redirect to https://www.jboss.org/tools/docs/reference/

IMHO, this is much better. Does everyone agree?


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