联系

支持

不同类型的问题或讨论对应不同的沟通渠道;请查看下面的描述,确保选择正确的方法。

需要帮助排除系统故障吗?首先,请搜索`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__,看看是否有其他人遇到过类似的问题,以及他们的解决方法是否适用于您。

如果没有,可以在`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__上提出新问题。请确保至少添加标签,最少添加``ros2``标签和您正在运行的发行版本,例如``humble``。如果您的问题与此处的文档相关,请添加一个类似``docs``或更具体的``tutorials``的标签。

贡献支持

ROS 2的用户来自各种技术背景,使用各种不同的操作系统,并不一定具有ROS(1或2)的任何先前经验。因此,对于任何经验水平的用户来说,提供支持都是很重要的。

如果您在`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__上看到与您自己遇到的类似的问题,请考虑提供一些有助于解决问题的指导。如果您不确定您的回答是否正确,不必担心。只需说明情况,其他社区成员将在必要时提供帮助。

问题

如果你发现错误,有改进的建议,或者针对某个软件包的特定问题,你可以在GitHub上开一个issue。

例如,如果你在这里 tutorials 进行教程,并且遇到在你的系统上无法工作的指令,你可以在 ros2_documentation 仓库中开一个issue。

你可以在 ROS 2的GitHub 上搜索个别ROS 2仓库。

在提交问题之前,请通过搜索ros2和ament的GitHub组织中的问题来查看其他用户是否已报告类似的问题:示例搜索查询

接下来,请在`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__上查看是否有其他人提出了您的问题或报告了您的问题。

如果尚未报告,请随时在相应的存储库跟踪器中提交问题。如果对于特定问题不清楚使用哪个跟踪器,请将其提交到`ros2/ros2存储库 <https://github.com/ros2/ros2/issues>`__,我们会查看它。

在提交问题时,请确保:

  • 提供足够的信息,以便其他人理解问题。

准确描述您正在做的或尝试做的事情,以及出了什么问题(如果有的话)。如果遵循教程或在线说明,请提供链接到具体说明的位置。

  • 使用一个描述性的标题或主题行。不好的例子:“rviz不工作”。好的例子:“在最新的apt更新之后,Rviz崩溃了,寻找丢失的.so文件”。

  • 包含与问题相关的确切平台、软件、版本和环境信息。这包括你是如何安装软件的(从二进制文件还是从源代码),以及你正在使用哪个ROS中间件/DDS供应商(如果你知道的话)。

  • 任何警告或错误信息。请直接从打印它们的终端窗口中复制粘贴。请不要重新输入或包含截图。

  • 如果存在错误,请考虑提供一个“简短、自包含、正确(可编译)的示例 <http://sscce.org/>`__。

  • 在讨论任何编译/链接/安装问题时,还要提供编译器的版本。

根据情况,还可以包括以下内容:

  • ROS 环境变量 (env | grep ROS)

  • 回溯信息

  • 相关配置文件

  • 显卡型号和驱动程序版本

  • 如果可能,请提供 rviz 的 Ogre.log(使用 rviz -l 运行)

  • 可以重现问题的 Bag 文件和代码示例

  • 演示问题的GIF或视频

拉取请求

当您感到足够自信直接对代码提出具体的更改建议时,您可以提交一个拉取请求。欢迎为任何`ROS 2代码库 <https://github.com/ros2>`__提交拉取请求。有关如何做出贡献的详细信息和礼仪,请参阅:doc:`Contributing <The-ROS2-Project/Contributing>`页面。

讨论

要与其他ROS 2社区成员开始讨论,请访问官方的`ROS讨论平台 <https://discourse.ros.org/>`__。Discourse上的内容应该是高级别的;它不是一个解答代码*问题*的地方,但它适合开始关于最佳实践或改进标准的对话。

有关ROS 2开发和计划的讨论正在`“Next Generation ROS” Discourse分类 <https://discourse.ros.org/c/ng-ros>`__中进行。参与这些讨论是对ROS 2的不同功能如何工作和实现提出意见的重要方式。

ROS生态系统背后的多元社区是其最大的优势之一。我们鼓励ROS社区的所有成员参与这些设计讨论,以便利用社区成员的经验,并兼顾ROS的各种使用情况。

礼仪

假设'善意': 在互联网上很容易误解评论的意思或语气。假设善意可以给那些试图帮助你的人以怀疑的好处,避免侮辱那些出于善意的社区成员并破坏气氛。即使最初的回复实际上不是出于善意,回应时假设'善意'通常会更好地起作用。

请不要重复发送你的问题:问题已经被看到。如果你没有得到回复,很可能是因为没有人有时间回答你。或者,可能没有人知道答案。无论如何,再次发送是不恰当的行为,类似于大声喊叫,很可能激怒很多人。这也适用于转贴。请尽量选择你认为最匹配的论坛并在那里提问。如果你被引导到一个新的论坛,请提供旧讨论的链接。

在`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__上,您可以编辑您的问题以提供更多细节。您在问题中包含的细节越多,其他人帮助您找到解决方案的难度就越小,这样您就更有可能获得答复。

列出个人截止日期被认为是不恰当的行为;回答问题的社区成员也有自己的截止日期。

不要乞求帮助。如果有人愿意并能够帮助解决你的问题,你通常会得到回应。请求更快的答案通常会产生负面效果。

不要在帖子中添加无关内容。帖子的内容应集中在手头的主题上,不应包含无关内容。与主题无关的内容、链接和图片被视为垃圾邮件。

对于商业帖子,也可参考`此讨论 <https://discourse.ros.org/t/sponsorship-notation-in-posts-on-ros-org/2078>`_。

请尽量减少引用付费内容。在`ROS Discourse <https://discourse.ros.org/>`__和`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__上发布的内容应该“通常”对所有用户免费开放。尽管付费内容有助于解决问题并具有相关性,但可能不是所有用户都能访问的。在可能的情况下,主要来源应该是免费和开放的,付费内容则起支持作用。

应避免发布单一链接帖子。一般来说,发布仅包含一个链接的答案不太有帮助,很容易被误认为是垃圾邮件。此外,链接可能随时间而失效或被替换。用链接的内容进行改写,并加上一些上下文信息和归属,通常更有帮助。

私人联系方式

如果您希望以私密方式与我们联系(例如,如果您的问题涉及组织或项目的敏感信息,或者涉及安全问题),您可以直接发送电子邮件至``ros@osrfoundation.org``。