[ros-users] New Documentation Generation and Indexing for ros.org

[Eitan Marder-Eppstein]

Hey all,

Sorry that's it's taken me a bit to chime in on things. It's been a hectic
start to the week

Patrick, for your packages, if you submit a repository to the Fuerte
indexer, you'll get headers auto-generated for that distribution. The same
can be said for Groovy. So, you shouldn't have to manually add headers.
With electric, it's a bit trickier because that's still running the old
documentation indexer and running off the distro file of released stacks.
If there's a ton of demand to have headers generated for electric, there
might be a way for me to create a hybrid system of the old and new
indexers, but it's an item that hasn't been high on my priority list. As
Christain mentioned/quoted, documentation for electric was actually never
very complete, it's just that no one noticed because distro-level browsing
wasn't something that you could really do on the wiki.

As for the unstable builds that Mani mentions, there are still some issues
that I'm having with getting message generation to run properly during
documentation. I'm going to try to solve this problem this week. So, for
now, ignoring the fact that a build is unstable is OK. Perhaps I should
remove those messages from the wiki until I fix the problem that is causing
the majority of this instability  Once this issue is fixed, however, the
idea is that stack maintainers can see why their builds are failing or
unstable and make fixes to their repositories as needed. This should all
work properly soon, sorry for the state of limbo that exists in the
near-term.

Hope this helps and that all is well,

Eitan

On Mon, Nov 5, 2012 at 7:36 PM, Patrick Goebel <patrick at pirobot.org> wrote:

> Thanks Christian,
>
> So I guess I need to go back and add the header manually to each wiki page
> for now.
>
> --patrick
>
>
> On 11/05/2012 01:59 AM, Christian Dornhege wrote:
>
>> On 03.11.2012 14:02, Patrick Goebel wrote:
>>
>>> Sorry to be so dense everyone, but can someone tell me if packages that
>>> have long existed in the indexer for ROS Electric (e.g. pi_face_tracker)
>>> need to be resubmitted to ros-users to have the correct header created
>>> on the Wiki page?  At the moment, all my old Wiki pages have the
>>> following message at the top even for Electric:
>>>
>>> Cannot load information on*name: pi_face_tracker, distro: electric*,
>>> which means that it is not yet in our index. Please seethis page
>>> <http://www.ros.org/wiki/Get%**20Involved#Indexing_Your_.2A-**
>>> ros-pkg_Repository_for_**Documentation_Generation<http://www.ros.org/wiki/Get%20Involved#Indexing_Your_.2A-ros-pkg_Repository_for_Documentation_Generation>>for
>>>
>>> information on how to submit your repository to our index.
>>>
>>> And it appears that it is not just my packages but others (e.g.
>>> face_recognition).  Or is the new requirement that the package has to
>>> exist as a Debian package?
>>>
>>
>> It is the same for our packages. Let me quote Eitan's reply to my
>> question:
>>
>> On Wed, Oct 31, 2012 at 5:57 AM, Christian Dornhege <
>> dornhege at informatik.uni-**freiburg.de<dornhege at informatik.uni-freiburg.de>>
>> wrote:
>> > Was this behavior maybe changed at some time? I remember it indexing
>> our trunk/ URL. Now it seems that only the packages are indexed that have
>> been released as debs.
>>
>> The behavior for electric documentation always worked this way. However,
>> there was a separate indexer that ran off of rosinstall files documenting
>> whatever was in them, but that is no longer run in favor of the new system.
>> It's possible that this old indexer produced your headers and
>> documentation, but the docs for electric specifically were never generated.
>> With the old wiki, no one would have noticed this as per-distro browsing
>> wasn't something that was really possible to do. The old indexer job was
>> kind of weird to begin with since it could allow for documentation to be
>> mixed between distros... leading to some weird effects.
>>
>>
>> Best,
>>   Christian
>>
>>
>>> Thanks!
>>> patrick
>>>
>>>
>>>
>>>
>>>
>>>
>>> ______________________________**_________________
>>> ros-users mailing list
>>> ros-users at code.ros.org
>>> https://code.ros.org/mailman/**listinfo/ros-users<https://code.ros.org/mailman/listinfo/ros-users>
>>>
>>>
>>
>>
> ______________________________**_________________
> ros-users mailing list
> ros-users at code.ros.org
> https://code.ros.org/mailman/**listinfo/ros-users<https://code.ros.org/mailman/listinfo/ros-users>
>



-- 
Eitan Marder-Eppstein
President, hiDOF Inc.
http://www.hidof.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.ros.org/pipermail/ros-users/attachments/20121106/4dddcfa3/attachment-0004.html>