问题报告#

GNOME 软件的问题可以使用 GitLab 中每个模块的问题跟踪器进行报告。问题报告应根据以下准则创建。

通用准则#

  • GNOME 仅接受对两个最新稳定版本或当前开发版本的错误报告。如果您使用的 GNOME 版本不再受支持，您可以尝试在新版本中重现该问题。虚拟机可以是一种有用的方法。

  • 问题报告应基于事实和描述性，并应坚持手头的技术和设计问题。请避免情绪化语言或判断（包括表达不满、愤怒、愤慨或失望）。问题跟踪器上的所有互动都应遵循 行为准则。

  • 每个问题报告应限制于单个问题或功能请求。如果您有多个问题，请为每个问题创建单独的报告。

  • 在编写报告时，请描述您的个人体验，而不是笼统或抽象地争论您的观点。尽量避免在没有提供此背景信息的情况下提出解决方案或提出请求。

  • 对您的期望保持现实。GNOME 项目收到的问题报告比其能够解决的数量多，因此请注意，您的问题可能无法得到修复。此外，开发人员可能无法立即回复您的报告。

问题报告步骤#

问题报告使用 GNOME 的 GitLab 创建

  • 在 GitLab 中，通过搜索或浏览 GNOME 项目列表 找到您的问题的软件项目。如果您不确定应该针对哪个模块报告您的问题，可以在 Matrix 或 Discourse 中寻求建议，或者尝试搜索类似的 GNOME 项目组中的问题。

  • 打开模块后，在侧边栏中选择 Issues。

  • 通过搜索与您的问题相关的不同术语，检查该问题是否已经报告过。（在执行此操作时，请确保查看开放式和已关闭问题的搜索结果。）如果您找到针对您问题的现有报告

    • 如果报告是针对旧版本的 GNOME，您可以添加评论说明该问题存在于您使用的版本中。

    • 您可以为原始问题报告添加点赞 (+1)，也可以订阅该问题以接收更新。

  • 如果您没有找到针对您问题的现有报告，请通过单击页面顶部的蓝色 New issue 按钮来创建新问题。如果您尚未登录，系统将提示您登录。

编写报告#

高质量的报告更容易处理、诊断和解决。因此，请在创建问题时花时间和精力，并遵循以下准则

  • 避免宽泛和含糊不清的标题。相反，为您的问题提供一个描述性标题，其中包含具体信息。

    • 示例：不要写“在线帐户无法工作”，而要写“添加 Nextcloud 在线帐户时浏览器窗口为空/空白”。

  • 问题的正文应包括详细的描述。这应包括

    • 发生了什么情况的描述，以一系列步骤的形式编写。这应包括您采取的措施、您期望发生的情况以及实际发生的情况。尝试从您的个人角度讲述它。

    • 问题发生的频率。它每次都发生，还是有时发生？它是否只在特定条件下发生？

  • 问题报告还应包括

    • 发生问题的组件的版本。

    • 发行版及其版本。

    • 如果您报告的问题可以在屏幕上看到，则需要截屏或屏幕录像。（在拍摄这些照片时，请确保您的系统设置为美国英语。）

    • 如果报告是崩溃，则理想情况下应包括 堆栈跟踪（没有此信息，将很难修复）。

功能请求#

大多数问题描述的是问题：要么是无法正常工作的事情，要么是不如它可能容易使用的东西（这些通常被称为“错误”）。但是，在某些情况下，报告者可能希望使用问题来请求当前缺失的功能或功能。

执行此操作的准则

  • 某些 GNOME 模块要求在问题跟踪器以外的论坛中提出功能请求。建议检查模块的 GitLab 页面和问题模板，以查看是否是这种情况。

  • 在请求新功能时，提供有关您想要该功能的背景信息非常重要。这可能包括有关

    • 当前功能集为何不足

    • 来自您的环境或用例的实际因素，这些因素使该功能对您很重要

    • 影响您请求的个人偏好或经验

  • 请注意，新功能可能需要开发人员付出大量时间和精力，并且需要将功能请求与现有的开发计划相协调。通常还需要与设计团队进行协商。