<div dir="ltr">We do (or more precisely OSUOSL does) have control over the <a href="http://docs.ros.org">docs.ros.org</a> webserver.<div><br></div><div>Currently the "api" folder itself is a symlink to "jade/api".</div><div>So if a package "foo" does not have any documentation in "jade" then "api/foo" simply doesn't exist.</div><div><br></div><div>The proposed dummy html files for every package in every distro which doesn't have documentation is not sufficient imo.</div><div>This way deep linking (e.g. "api/foo/something/myinfo.html") would still fail.</div><div><br></div><div>Instead we could have a script (e.g. PHP) intercepting all URLs under "api" and redirect the client to the "api" of the latest rosdistro which contains the requested URL.</div><div>E.g. "api/foo/something/myinfo.html" gets redirected to "indigo/api/foo/something/myinfo.html" since "indigo/api/foo/something/myinfo.html" does not exist.</div><div>This could also be achieved with a mod_rewrite rule (but I am not sure if mod_rewrite allows to specify the rules in a way which doesn't require future distros to be added manually).</div><div><br></div><div>If anybody would like to contribute such a script / ruleset that would be great.</div><div>I am not sure when we would find the time to work on this.</div><div><br></div><div>Cheers,</div><div>- Dirk</div><div><br></div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Jun 3, 2015 at 6:55 AM, Mike Purvis via ros-users <span dir="ltr"><<a href="mailto:ros-users@lists.ros.org" target="_blank">ros-users@lists.ros.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Relatedly, I'm wondering if the server config for <a href="http://docs.ros.org/api" target="_blank">docs.ros.org/api</a> could be modified to fall back to the most recent available distro. So, for example,<div><br></div><div><a href="http://docs.ros.org/api/roscpp/html/" target="_blank">http://docs.ros.org/api/roscpp/html/</a> is a symlink/copy of <a href="http://docs.ros.org/jade/api/roscpp/html/" target="_blank">http://docs.ros.org/jade/api/roscpp/html/</a></div><div><br></div><div>But</div><div><br></div><div><a href="http://docs.ros.org/api/hardware_interface/html/" target="_blank">http://docs.ros.org/api/hardware_interface/html/</a> is a 302 redirect to <a href="http://docs.ros.org/indigo/api/hardware_interface/html/" target="_blank">http://docs.ros.org/indigo/api/hardware_interface/html/</a> (until ros_control is released for Jade)<br></div><div><br></div><div>It's frustrating trying to balance giving users URLs which will be "always current" with the reality that some stuff can't be released immediately into the new distro and therefore all the /api URLs break.</div><div><br></div><div>If you guys have control over the webserver, this fallback behaviour is pretty easy to set up in nginx or Apache. Alternatively, you could simply generate in the /api folder dummy pages which announce to the user "This package's documentation isn't available in ROS Jade, please select a previous distro from the list below." Though, a transparent redirect is ideal, as it would work with deep links also.</div><div><br></div><div>M.</div><div><br></div><div><br></div></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><div class="gmail_quote">On 3 June 2015 at 04:01, Isaac I.Y. Saito via ros-users <span dir="ltr"><<a href="mailto:ros-users@lists.ros.org" target="_blank">ros-users@lists.ros.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">A possible question might be what we use as the default distro (on<br>
wiki or possibly anywhere else): the latest available distro, or the<br>
latest LTS?<br>
<br>
+1 to "default: LTS".<br>
With Long-Term Support system from Indigo that had been very much<br>
wanted (at least I strongly feel so; LTS and its end-date is one of<br>
the most FAQs users/potential users from industry esp. in Japan ask),<br>
I thought some (/ many) package maintainers would lean more toward<br>
focusing on LTS distros.<br>
<br>
Isaac<br>
<span><br>
On Tue, Jun 2, 2015 at 5:54 PM, Daniel Stonier via ros-users<br>
<<a href="mailto:ros-users@lists.ros.org" target="_blank">ros-users@lists.ros.org</a>> wrote:<br>
><br>
><br>
</span><div><div>> On 7 May 2015 at 05:55, William Woodall via ros-users<br>
> <<a href="mailto:ros-users@lists.ros.org" target="_blank">ros-users@lists.ros.org</a>> wrote:<br>
>><br>
>> Hi everyone,<br>
>><br>
>> For everyone out there that has been working on the documentation for<br>
>> Jade, first of all thanks! Second of all, I just wanted to let everyone know<br>
>> I just updated the ROS distro versioned blocks on the wiki to accept the<br>
>> `_and_newer` and the `_and_older` suffixes. This should make it easier to<br>
>> have sections of your wiki pages that stay up to date version to version,<br>
>> and should be generally more flexible. Please have a look at the updated<br>
>> documentation:<br>
>><br>
>> <a href="http://wiki.ros.org/WikiMacros#Version" target="_blank">http://wiki.ros.org/WikiMacros#Version</a><br>
><br>
><br>
> Something that would be very useful for us would be to lock down the default<br>
> landing page to a particular version. We've got quite a few packages we only<br>
> have the resources to support/upgrade for the long term releases (e.g.<br>
> indigo) and it's rather repetitive always having to click back from the<br>
> latest release page (where we usually put a message saying it's not<br>
> supported in this release) back to the indigo page.<br>
><br>
> Daniel.<br>
><br>
><br>
>><br>
>> Thanks,<br>
>><br>
>> On Fri, May 1, 2015 at 6:03 PM, William Woodall<br>
>> <<a href="mailto:william@osrfoundation.org" target="_blank">william@osrfoundation.org</a>> wrote:<br>
>>><br>
>>> Hi guys,<br>
>>><br>
>>> tl;dr: Jade beta is out!<br>
>>><br>
>>> ----<br>
>>><br>
>>> I'm happy to announce we're now in the Jade Beta! We're a few days behind<br>
>>> schedule, but thanks to the hard work of all our contributors we've now got<br>
>>> all of desktop-full released into Jade and available on <a href="http://packages.ros.org" target="_blank">packages.ros.org</a>.<br>
>>><br>
>>> Even though we're a bit behind schedule, we would like to try and keep<br>
>>> the original release date of May 23rd (also world turtle day [1] :D). That<br>
>>> gives us just under 23 days until the release. We'll keep that date unless<br>
>>> we run into a show stopper within desktop-full.<br>
>>><br>
>>> So between now and then I would encourage everyone who is able to:<br>
>>><br>
>>> Install `ros-jade-desktop-full` on Ubuntu and test out packages you<br>
>>> regularly use.<br>
>>><br>
>>> Testing on other platforms is also appreciated!<br>
>>><br>
>>> Try out any documentation that you can, including tutorials, package wiki<br>
>>> pages, and generated code docs.<br>
>>> Continue releasing packages and fill out the gaps between Jade and Indigo<br>
>>> where possible.<br>
>>><br>
>>> If you find any issues while testing, please locate the issue tracker<br>
>>> (usually on the corresponding wiki page for the package, e.g.<br>
>>> <a href="http://wiki.ros.org/rviz" target="_blank">wiki.ros.org/rviz</a>) and report the issue there.<br>
>>><br>
>>> Auditing documentation is more challenging just because there is so much<br>
>>> of it and searching on the wiki does not always make it easy to find pages<br>
>>> with distribution specific content. So to help with this, I've done some<br>
>>> special searches locally on the wiki's web server and compiled a list of<br>
>>> pages which _may_ need to be updated for Jade:<br>
>>><br>
>>> <a href="https://github.com/ros/rosdistro/issues/8284" target="_blank">https://github.com/ros/rosdistro/issues/8284</a><br>
>>><br>
>>> So if you have time, please look at that list, and do a spot check on any<br>
>>> pages that you use or have used in the past. Many of the core documentation<br>
>>> pages are absent from that list because I've compiled them separately in a<br>
>>> GitHub issue here:<br>
>>><br>
>>> <a href="https://github.com/ros/rosdistro/issues/6878" target="_blank">https://github.com/ros/rosdistro/issues/6878</a><br>
>>><br>
>>> Finally, if you are trying to release a package for Jade and the<br>
>>> dependencies are not there yet, please contact the maintainers or ask for<br>
>>> help on <a href="mailto:ros-release@lists.ros.org" target="_blank">ros-release@lists.ros.org</a>.<br>
>>><br>
>>> Thanks again to everyone who helped get the Jade beta out (mostly) on<br>
>>> time.<br>
>>><br>
>>> Cheers,<br>
>>><br>
>>> P.S. Only ros-jade-desktop is available on armhf right now, we're waiting<br>
>>> on an updated set of gazebo5 debs and then we'll have desktop-full on armhf<br>
>>> as well. Also, armhf is Trusty only right now.<br>
>>><br>
>>> P.S.S. If you are testing gazebo-ros integration, we are aware of an<br>
>>> issue with the launch files and are tracking it here:<br>
>>><br>
>>> <a href="https://github.com/ros-simulation/gazebo_ros_pkgs/issues/323" target="_blank">https://github.com/ros-simulation/gazebo_ros_pkgs/issues/323</a><br>
>>><br>
>>> A work around is to install `libgazebo5-dev` manually. We hope to have a<br>
>>> proper fix out soon.<br>
>>><br>
>>> [1] <a href="http://en.wikipedia.org/wiki/World_Turtle_Day" target="_blank">http://en.wikipedia.org/wiki/World_Turtle_Day</a><br>
>>><br>
>>> --<br>
>>> William Woodall<br>
>>> ROS Development Team<br>
>>> <a href="mailto:william@osrfoundation.org" target="_blank">william@osrfoundation.org</a><br>
>>> <a href="http://wjwwood.io/" target="_blank">http://wjwwood.io/</a><br>
>><br>
>><br>
>><br>
>><br>
>> --<br>
>> William Woodall<br>
>> ROS Development Team<br>
>> <a href="mailto:william@osrfoundation.org" target="_blank">william@osrfoundation.org</a><br>
>> <a href="http://wjwwood.io/" target="_blank">http://wjwwood.io/</a><br>
>><br>
>> _______________________________________________<br>
>> ros-users mailing list<br>
>> <a href="mailto:ros-users@lists.ros.org" target="_blank">ros-users@lists.ros.org</a><br>
>> <a href="http://lists.ros.org/mailman/listinfo/ros-users" target="_blank">http://lists.ros.org/mailman/listinfo/ros-users</a><br>
>><br>
><br>
><br>
><br>
> --<br>
> Phone : <a href="tel:%2B82-10-5400-3296" value="+821054003296" target="_blank">+82-10-5400-3296</a> (010-5400-3296)<br>
> Home: <a href="http://snorriheim.dnsdojo.com/" target="_blank">http://snorriheim.dnsdojo.com/</a><br>
> Yujin Inno: <a href="http://inno.yujinrobot.com/" target="_blank">http://inno.yujinrobot.com/</a><br>
><br>
><br>
> _______________________________________________<br>
> ros-users mailing list<br>
> <a href="mailto:ros-users@lists.ros.org" target="_blank">ros-users@lists.ros.org</a><br>
> <a href="http://lists.ros.org/mailman/listinfo/ros-users" target="_blank">http://lists.ros.org/mailman/listinfo/ros-users</a><br>
><br>
_______________________________________________<br>
ros-users mailing list<br>
<a href="mailto:ros-users@lists.ros.org" target="_blank">ros-users@lists.ros.org</a><br>
<a href="http://lists.ros.org/mailman/listinfo/ros-users" target="_blank">http://lists.ros.org/mailman/listinfo/ros-users</a><br>
</div></div></blockquote></div><br></div>
</div></div><br>_______________________________________________<br>
ros-users mailing list<br>
<a href="mailto:ros-users@lists.ros.org">ros-users@lists.ros.org</a><br>
<a href="http://lists.ros.org/mailman/listinfo/ros-users" target="_blank">http://lists.ros.org/mailman/listinfo/ros-users</a><br>
<br></blockquote></div><br></div>