Skip to main content

Electron 中的问题

🌐 Issues In Electron

如何对问题做出贡献

🌐 How to Contribute to Issues

对于任何问题,个人基本上有三种方式可以作出贡献:

🌐 For any issue, there are fundamentally three ways an individual can contribute:

  1. 通过发起问题讨论:如果你认为自己发现了 Electron 中的一个新错误,你应该通过在 electron/electron 问题追踪器 中创建一个新的问题来报告它。
  2. 通过帮助分类问题:你可以通过提供辅助细节(能够重现漏洞的测试用例)或提出解决问题的建议来做到这一点。
  3. 通过帮助解决问题:这可以通过证明问题不是一个漏洞或已经被修复来实现;但更多时候,是通过提交一个拉取请求,以具体且可审查的方式更改 electron/electron 中的源代码。

寻求一般帮助

🌐 Asking for General Help

Electron 网站 提供了一份获取编程帮助、报告安全问题、参与贡献等资源的列表。请仅将问题追踪器用于报告错误!

提交错误报告

🌐 Submitting a Bug Report

要提交错误报告:

🌐 To submit a bug report:

electron/electron 问题追踪器 中创建新问题时,用户将会看到一个需要填写的模板。

🌐 When opening a new issue in the electron/electron issue tracker, users will be presented with a template that should be filled in.

如果你认为自己在 Electron 中发现了一个错误,请尽力填写此模板。

🌐 If you believe that you have found a bug in Electron, please fill out the template to the best of your ability.

评估报告所需的两个最重要的信息是漏洞的描述和一个简单的测试用例来重现它。如果能够重现漏洞,修复起来会更容易。

🌐 The two most important pieces of information needed to evaluate the report are a description of the bug and a simple test case to recreate it. It is easier to fix a bug if it can be reproduced.

请参阅 如何创建最小、完整且可验证的示例

🌐 See How to create a Minimal, Complete, and Verifiable example.

对错误报告进行分类

🌐 Triaging a Bug Report

开放问题通常会涉及讨论。一些贡献者可能有不同的意见,包括是否将该行为视为错误或功能。这种讨论是进程的一部分,应保持专注、有帮助且专业。

🌐 It's common for open issues to involve discussion. Some contributors may have differing opinions, including whether the behavior is a bug or feature. This discussion is part of the process and should be kept focused, helpful, and professional.

简短的回复既不提供额外的背景信息,也不提供支持性细节,这样的回复既不有帮助,也不专业。对许多人来说,这类回复令人讨厌且不友好。

🌐 Terse responses that provide neither additional context nor supporting detail are not helpful or professional. To many, such responses are annoying and unfriendly.

鼓励贡献者共同解决问题,互相帮助取得进展。如果你遇到一个你认为无效的问题,或者其中包含错误信息,请解释你为什么这么认为,并提供额外的支持性背景,同时也要愿意接受自己可能错了的观点。通过这样做,我们通常可以更快地达成正确的结果。

🌐 Contributors are encouraged to solve issues collaboratively and help one another make progress. If you encounter an issue that you feel is invalid, or which contains incorrect information, explain why you feel that way with additional supporting context, and be willing to be convinced that you may be wrong. By doing so, we can often reach the correct outcome faster.

解决错误报告

🌐 Resolving a Bug Report

大多数问题可以通过创建拉取请求来解决。创建和审查拉取请求的进程类似于创建和处理问题的进程,但它需要一个必要的审查和批准工作进程,以确保所提议的更改符合 Electron 项目的最低质量和功能指南。

🌐 Most issues are resolved by opening a pull request. The process for opening and reviewing a pull request is similar to that of opening and triaging issues, but carries with it a necessary review and approval workflow that ensures that the proposed changes meet the minimal quality and functional guidelines of the Electron project.