联系

支持

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

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

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

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

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

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

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

提供支持

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

如果您在 Robotics Stack Exchange 上看到与您自己遇到的问题类似的问题,请考虑提供一些有助于解决您情况的提示。 如果您不确定您的回答是否正确,请不要担心。 只需说出来,其他社区成员会在必要时介入。

问题

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

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

您可以在 ROS 2 的 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”Discourse 类别 上进行。 参与这些讨论是就 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”。