Contact

支持

不同类型的问题或讨论对应不同的沟通渠道;

请查看以下描述以确保您选择了正确的方法。

需要帮助排除系统故障吗?

首先,搜索`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__,看看其他人是否遇到过类似的问题,以及他们的解决方案是否适合您。

如果没有,请在`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__上提出新问题。

确保添加标签,至少添加``ros2``标签和您正在运行的发行版,例如``rolling``。

如果您的问题与此处的文档相关,请添加标签,如``docs``,或更具体地说,tutorials

请不要直接联系开发人员/维护人员。 社区无法看到未公开提出或回答的问题或答案。 当整个社区都参与讨论并帮助回答问题时,开源开发才能发挥最佳作用。 最好将所有问题发送到`Robotics Stack Exchange <https://robotics.stackexchange.com/>`__,并将所有问题报告给问题跟踪器。

提供支持

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

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

问题

如果您发现错误、有改进建议或对某个软件包有疑问,您可以在 GitHub 上打开问题。

例如,如果您正在按照 tutorials here 进行操作,并遇到了在您的系统上不起作用的说明, 您可以在 ros2_documentation 存储库中打开问题。

您可以在 ROS 2’s GitHub 上搜索单个 ROS 2 存储库。

在打开问题之前,请通过在 ros2 和 ament GitHub 组织中搜索来检查其他用户是否报告了类似的问题:example search query

接下来,检查 Robotics Stack Exchange,看看是否有其他人问过您的问题或报告过您的问题。

如果尚未报告,请随时在相应的存储库跟踪器中打开问题。

如果不清楚要使用哪个跟踪器来处理特定问题,请将其提交到 ros2/ros2 存储库,我们会查看它。

提交问题时,请确保:

  • 包含足够的信息,以便其他人了解问题。

准确描述您正在做什么或正在尝试做什么,以及到底出了什么问题(如果有)。

如果遵循教程或在线说明,请提供指向特定说明的链接。

  • 使用描述性标题或主题行。错误:“rviz 不起作用”。好:“Rviz 在最新的 apt 更新后崩溃,寻找丢失的 .so”

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

  • 任何警告或错误。直接从打印它们的终端窗口剪切并粘贴它们。请不要重新输入或包含屏幕截图。

  • 如果出现错误,请考虑提供一个“简短、独立、正确(可编译)的示例 <http://sscce.org/>”__。

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

根据需要,还包括您的:

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

  • 回溯

  • 相关配置文件

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

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

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

  • 用于演示问题的 GIF 或影片

拉取请求

当您觉得可以直接对代码提出特定更改时,您可以提交拉取请求。 欢迎对任何 ros2 存储库 提出拉取请求。 有关如何做出贡献的更多详细信息和礼仪,请参阅 Contributing 页面。

讨论

要与其他 ROS 2 社区成员展开讨论,请访问官方 ROS Discourse。 Discourse 上的内容应为高级内容; 它不是回答有关代码的 问题 的地方,但适合开始有关最佳实践或改进标准的对话。

有关 ROS 2 开发和计划的讨论正在 “下一代 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”。