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

Tue Nov 6 15:28:48 UTC 2012

As a note, I've disabled the unstable notification until I have an
expectation that builds should be stable. You'll still receive a
notification if a build is failing, and I'll turn things back on once I've
got everything fixed and working well. The notification, as is, was just
causing confusion.

-Eitan

On Tue, Nov 6, 2012 at 7:23 AM, Eitan Marder-Eppstein <eitan at hidof.com>wrote:

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

-- 
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/39e75c06/attachment-0004.html>