Skip to content

Latest commit

 

History

History
145 lines (100 loc) · 9.63 KB

CONTRIBUTING_HOME.md

File metadata and controls

145 lines (100 loc) · 9.63 KB

如何贡献

翻译:刘怡(AlexLEWIS)

校对:何镇汐,孟帅洋,夏申斌,王绍明赵亮(BeiMeng)

列位,最简单的贡献之策是参与话题或问题(issues)的讨论,当然你也可以修改代码并一并通过 pull request 提交给我们。

普通反馈与讨论

可以在 Asp.Net 团队的 Home 仓库问题跟踪 频道中发起讨论。

BUGs 与细节请求

对于非安全相关的 BUG,请移步至相关 Github 仓库中记录该新问题。下面是几个常用仓库:

或前往 aspnet 组织浏览完整的仓库清单。

报告安全性问题与 BUGs

安全性问题和 BUG 需要通过邮件私下报告给微软安全响应中心(Microsoft Security Response Center,MSRC),他们的邮件地址是:[email protected]。你会在 24 小时内得到响应。如果因故未能得到响应,请通过邮件跟进以确认我们是否已收到你的原始信件。更多信息(包括 MSRC PGP key)可在 安全技术中心(Security TechCenter) 中获得。

其他讨论

我们团队同时也密切关注下列几个论坛:

提问题的智慧

请用我们的 BUG 模板 提交问题。

为了修正你所提交的 BUG ,你最好尽可能详细地提供关于这个问题的一切信息。

如果能提供一个小项目来重现这个问题则更佳。

在你发送 BUG 前先回答下面几个问题,以确保你没有遗漏任何重要信息。

  1. 是否已阅读 文档
  2. 是否在所提交的问题中包含了代码片段?
  3. 能重现该问题的明确步骤
  4. 你当前所使用的 package 的版本号(这些信息位于 project.json 文件内)。
  5. 你当前所使用的操作系统。
  6. 你当前所使用的 IIS 版本号。

Github 支持 markdown 格式,所以在点击提交 BUG 之前请务必检查你的格式。

贡献代码和内容

在你提交 pull request 之前需先登录 贡献者许可协议(Contributor License Agreement,CLA)。为完成 CLA,你得提交申请单,然后你会收到一封包含 CLA 文档链接的邮件,点击前往并作电子签名。所有 .NET 开源软件项目都只需完成这一次。

请确保能生成你的代码,熟悉项目流程和编码规范。如果你不知道何谓 pull request 请先阅读这篇文章:https://help.github.com/articles/using-pull-requests。

在提交功能点或大量代码贡献之前,先与团队讨论一下以确保其遵循产品路线图。你或可先去阅读下面这两篇关于代码贡献的博文:Miguel de Icaza 的 《开源贡献之道》(Open Source Contribution Etiquette) 和 Ilya Grigorik 的 Don't "Push" Your Pull Requests。注意,所有代码提交都将被严格审查并经由 ASP.NET 和 Entity Framework 团队测试。只有那些质量极高且合乎我等规划的代码才会被合并到我们的源中。

在你更新代码前请牢记下面几件事情:

工程指导原则

代码、风格与通用工程指导原则皆已发表在 Engineering guidelines 页中。

提交/拉取请求格式

Summary of the changes (Less than 80 chars)
 - Detail 1
 - Detail 2

Addresses #bugnumber (in this specific format)

测试

  • 测试需要提供每一个所提交的 BUG/细节;
  • 如果当前问题已被 QA 所证实则只需测试;
  • 如果处在一个非常难以测试的场景中,则无需测试之。
    • 「非常难」这一定义取决于整个团队而言。