Electron中的问题

如何贡献一个Issue

对于任何问题,个人可以通过三种方式贡献:

  • 通过新建(提出)问题进行讨论:如果您认为您在Electron中发现问题,您应该在electron/electron问题跟踪器中通过创建问题来提出。
  • 通过帮助鉴定问题:您可以通过提供辅助信息(一种可以让漏洞被发现的情况)或提出解决问题的建议。
  • 通过帮助解决问题:这可以通过演示问题不是一个bug或已修复来完成;但更通常,打开一个通过一个具体和可审查的方式改变electron/electron中的源代码的拉取请求。

请求一般性的帮助

"Finding Support" has a list of resources for getting programming help, reporting security issues, contributing, and more. 请仅对漏洞使用问题追踪器!

提交漏洞报告

当您在Electron中提出问题,您需要完成一个模板。

  1. <!--
  2. 谢谢您提出问题! 请记住以下几点:
  3. - 问题跟踪器只能用于漏洞和功能的提出。
  4. - 在提出问题之前,请尝试使用最新版本的Electron让您提出的问题重现。
  5. 如果您需要一般的问题,请参与我们的Slack: http://atom-slack.herokuapp.com
  6. -->
  7. * Electron版本:
  8. * 操作系统:
  9. ### 你希望得到的结果
  10. <!-- 你觉得应该发生什么? -->
  11. ### 实际结果
  12. <!-- 实际发生了什么? -->
  13. ### How to reproduce
  14. <!--
  15. Your best chance of getting this bug looked at quickly is to provide a REPOSITORY that can be cloned and run.
  16. 你可以克隆 https://github.com/electron/electron-quick-start 并包含一个到含有你更改的分支的链接。
  17. 如果您提供了一个URL,请列出克隆/设置/运行您的仓库所需要的命令,例如
  18. $ git clone $YOUR_URL -b $BRANCH
  19. $ npm install
  20. $ npm start || electron .
  21. -->

如果你确信你发现了Electron中的漏洞,请尽力填这份表单。

要评估报告需要的两个最重要的部分是漏洞的描述和重现它的简单测试样例。 一个可以被重现的漏洞更容易被修复。

参见 如何创建一个最小的,完整的和可验证的例子

鉴定漏洞报告

提出问题经常会出现讨论。 贡献者会有不同的观点,包括提出的情况是一个漏洞还是一个功能。 这些讨论是解决问题的一部分,并且应该保持专注、有用、专业。

没有任何内容和详细信息的简单回复是无用的而且不专业的。 在很多情况下,这些恢复是烦人而且不友好的。

我们鼓励贡献者共同解决问题并互相帮助取得进展。 如果您遇到觉得包含无效或不正确信息的问题,请使用更多详细信息指出您为什么觉得此问题含有无效或不正确信息,并愿意接受您可能是错误的。 通过这样做,我们可以更快地得到正确的结果。

解决漏洞报告

大部分的问题是通过打开拉取请求解决的。 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.