[Documentation] [TitleIndex] [WordIndex

Connect with the Community

ROS Blogs

See the ROS Planet feed for what others are doing.

You can also monitor the ROS.org news site for official announcements from the community.

ROS Discourse

discourse.ros.org is the community's discussion forum. It is not for specific technical questions, but rather bigger picture topics, announcements and news.

Please do not post questions on the discourse.ros.org!

They should go to ROS Answers.

Deprecated ros-users mailing list

For the time being posts from Discourse are being forwarded to the previously used ros-users@lists.ros.org mailing list to smooth the transition. For existing subscribers it is recommended to create an account on Discourse, customize your notifications, and unsubscribe from ros-users. Direct postings to ros-users will be disabled. For further details refer to the Discourse announcement.

ROS Answers

The place for questions and answers about ROS. ROS Answers provides a forum, which can be filtered by tags to make sure the relevant people are included and not overload everyone.

Special Interest Groups

Special Interest Groups - or SIGs - focus on specific subtopics, and help guide development efforts.

SIG mailing lists have been deprecated in favor of Discourse categories. Please read http://discourse.ros.org/t/ros-sig-migration-method/35

Refer to the SIG summary page for links to old SIGs and their mailing lists.

IRC

#ros on chat.freenode.net. This channel is official, but we are still migrating from the one below. Logs of the chats are available at https://botbot.me/freenode/ros

#ROS on irc.oftc.net. Not an "official" channel... but it is there.

Web clients (make sure to change your nickname):

ROSCon

ROSCon is the annual ROS developers conference. It is a great opportunity to meet others in the community in real life. And even if you cannot attend we record the presentations. Visit roscon.ros.org to find out about upcoming events and browse the archives of all the past events.

Development and Best Practices

Latest Distribution Releases

On the Distributions page, you will see a list of current and future ROS distribution pages. Planning notes for upcoming distributions will be on the relevant wiki page, e.g. Hydro Planning.

ROS Enhancement Proposals (REPs)

The REP process, closely modeled on Python's PEP process, allows the community to participate in the ongoing development of ROS. For more information, see the REPs page.

Repositories

To maximize community participation, we follow a federated repository model: rather than having one true place for all ROS packages, users and developers around the world can host their own repositories of ROS packages. You can setup your own public repository or use free hosting online.

GitHub

The ROS community has standardized repository location by suggesting that everyone use GitHub. The Open Source Robotics Foundation has switched to use GitHub as the primary hosting site. The ease of collaboration using the GitHub ecosystem has proven very effective. See Recommended Repository Usage.

GitHub Organizations

There are several GitHub organizations which host many of the core ROS packages. This is the primary location for submitting Issues/bugs, contributing patches and discussing issues directly with the developers. You are encouraged to fork projects and send pull requests as needed.

See ROS GitHub Organizations

Historical Hosting Sites

Core ROS packages and Willow Garage development work has historically been hosted at the following locations:

Create Your Own ROS package Repository

There are hundreds of ROS repositories hosted by companies, universities, and individuals around the world. Whether you're releasing one ROS package or hundreds, feel free to start your own repository to share your code with the rest of the community.

Once you created your own public repository, add that to ROS package index for automatically generating document. Doing so will automatically populate the information of your package on ros.org so that it can get better visibility among the community. It also enables ros.org to add your packages into the package list, which is utilized in various service it provides (e.g. package search).

Release Binary Packages

To release binary packages we use the bloom tool. Here is the list of tutorials for releasing software onto the ROS buildfarm for binary packaging.

If you have two factor authorization enabled on github, and you want bloom to be able to manually create pull requests for you:

Some helpful information to maintain a ROS package which are not directly related to bloom:

Here are some unofficial notes and tutorials which can provided additional help if you are having trouble releasing:

Participating in Software Reviews

Design and peer review documentation for ROS packages are available online. On all package pages, e.g. actionlib, there is a link to 'Reviews' that will show you a list of any API or documentation reviews that have occurred. These review notes generally contain design goals and motivation as well.

The general process for a review is (this may be out of date: we generally use GitHub now):

While meetings have generally been held in person, it is possible to have open meetings (e.g. GitHub) if people express interest on the mailing list.


2017-03-18 12:16