The OSRF is putting forward a proposed policy for the naming of GitHub organisations that contain ROS and ROS-based software. This new policy was created taking into account the historical way GitHub organisations were named as part of the ROS project and the changing needs of the community, while also balancing the continued growth of the community, the need for a sustainable model of organisation management and package findability, the desire to clearly identify what is managed by the OSRF, and the need for the OSRF to steward the ROS, Gazebo, and other relevant brands on behalf of the community.
Historically, when a GitHub organisation was created with âros-â in the name, the ROS maintainers (first at Willow Garage, then at the OSRF) requested administrator/owner control be given to someone associated with the ROS maintainers. This was done because having ârosâ in the organisation name was interpreted as special by the community and so someone core to ROS needed to be involved to ensure correct use. This is the origin of organisations such as âros-driversâ and âros-planningâ. This will now change.
No enforcement of GitHub organisation naming
First, and most importantly, the OSRF will no longer try to exercise any control over GitHub organisations beginning with âros-â and âgazebo-â, other than those that it already manages. Trying to police the naming of GitHub organisations would be a futile and time-consuming game of Whac-A-Mole - with a lot less of the expected fun of playing the actual game of Whac-A-Mole.
An extension of the above is that, as with similar software-related terms such as Linux, we will not stop someone using ârosâ, âgazeboâ or ârmfâ anywhere in their Github organisation name.
A Github organisation or repository including ârosâ, âgazeboâ or other similar terms in the name cannot and should not be taken as a sign that the OSRF endorses that project or as a sign of quality.
Please note that creating a Github organisation or repository that contains words like âosrfâ or âopen roboticsâ will be taken much more seriously.
Caveats
There is an important caveat to this policy: We will not object to a GitHub organisation being named, for example, âros-autonomyâ, but if trademark infringement, trademark misuse, or misrepresentation is occurring, we will need to take action to protect and preserve the community brands to ensure that they are not devalued. We have a trademark usage guide available for ROS to help you understand how to use the ROS name correctly, and will prepare similar guides for the OSRFâs other registered and common-law trademarks.
We would also like to take this opportunity to offer some naming advice. If your organisation is called something like âros-autonomyâ, you may wish to reconsider your choice of organisation name to maximise the discoverability of your packages through a more descriptive name.
Package discoverability
Long-time members of the community often sing laments over the difficulty of finding packages that fill a specific purpose, such as drivers. This is one of the reasons that the ROS Index was created. We admit that the ROS Index is not perfect; improving it is an item on a very long list of things that need to be done. With the successful launch of the OSRA, we hope to soon have the funding to enable us to take on tasks such as this. If you wish to contribute financially to enabling the OSRF to target critical community needs for rapid improvement, consider joining the OSRA.
REP 2005 is another source of well-known packages that are commonly used. As part of the launch of the OSRA, REP 2005 has always been set for a revision. The revision will now also take into account this organisation naming policy, and part of the revision will involve categorising the list to make it clear which are managed by the OSRF, and which are not.
Existing GitHub âros-â organisations
For the time being, the OSRF will maintain its management of the existing GitHub organisations that it controls. We have no plans to move any repositories out of existing organisations at this time.
The core ROS team at Open Robotics made use of the access they have to repositories contained in âros-â organisations to push changes in not-actually-core âros-â repositories when necessary to facilitate a release or accelerate a necessary fix. While the OSRF believes that such access is a benefit to ensuring up-to-date binary releases of as many packages as possible continue to be available, this is not an approach that is sustainable in the long term.
We intend to transition away from this as we gradually re-organise the ROS repositories managed by the OSRF. We have no current plans to move any repositories out of existing organisations, but it is now less likely that new repositories will be created in the existing organisations if they are not being directly managed by the ROS maintainers. Once we have improved the package discovery tools, we will revisit the existing organisations and repositories.
Request for comments
Before we finalise this policy, we would like to hear your thoughts. What do you like, and what (if anything) would you like changed? Are you aware of any negative impacts that may occur? Donât wait, let us know now by replying to this thread so we can consider how to improve the policy.
Formal policy statement
The policy statement, as will be posted on the websites once finalised, is given below.
The Open Source Robotics Foundation (OSRF) manages (has âownerâ permissions on) a number of GitHub organisations. An incomplete list of such organisations is given below.
- ros
- ros2
- ros-infrastructure
- ros-planning
- ros-drivers
- ros-manipulation
- gazebosim
- gazebo-tooling
- gazebo-release
- gazebo-web
- gazebo-forks
- open-rmf
Creators of software based on or related to OSRF software may create their own Github organisations and repositories that follow a similar naming pattern, such as starting with âros-â or âgazebo-â. Much like the Linux Foundation does not own the hundreds of thousands of repositories with âlinuxâ in the name, the OSRF will not be policing the creation of such organisations and repositories, and in general will not try to prevent their creation.
However, if an organisation or repository name follows one of the above patterns, this should not be taken as an indication that it has been endorsed by the OSRF or as a sign of quality. Verify who manages an organisation or repository, rather than depending on the name alone.
In addition, it is an unfortunate reality that the OSRF must be proactive when it finds infringement, misuse, or misrepresentation of its registered and common-law trademarks. If we encounter an organisation or repository that is being used in a way that conflicts with the OSRFâs trademarks, we will contact the owners to resolve the situation. An example of this is naming your product using ROS or a ROS-derivative name or any other trademark owned by Open Robotics and then naming your Github org accordingly.
Due to the need for strong protection of the Open Robotics non-profit, including the brand and the image of the non-profit organisation in general, we will not be permitting anyone to create an organisation or a repository related to robotics with a name containing âosrfâ or âopen roboticsâ.