校对:何镇汐,孟帅洋,夏申斌,王绍明,赵亮(BeiMeng)
列位,最简单的贡献之策是参与话题或问题(issues)的讨论,当然你也可以修改代码并一并通过 pull request 提交给我们。
可以在 Asp.Net 团队的 Home 仓库问题跟踪 频道中发起讨论。
对于非安全相关的 BUG,请移步至相关 Github 仓库中记录该新问题。下面是几个常用仓库:
或前往 aspnet 组织浏览完整的仓库清单。
安全性问题和 BUG 需要通过邮件私下报告给微软安全响应中心(Microsoft Security Response Center,MSRC),他们的邮件地址是:[email protected]。你会在 24 小时内得到响应。如果因故未能得到响应,请通过邮件跟进以确认我们是否已收到你的原始信件。更多信息(包括 MSRC PGP key)可在 安全技术中心(Security TechCenter) 中获得。
我们团队同时也密切关注下列几个论坛:
- ASP.NET Core 论坛
- StackOverflow 中带有
asp.net-core
,asp.net-core-mvc
或entity-framework-core
标签的频道. - JabbR chat room 用于与社区和项目处理者进行即时讨论。
请用我们的 BUG 模板 提交问题。
为了修正你所提交的 BUG ,你最好尽可能详细地提供关于这个问题的一切信息。
如果能提供一个小项目来重现这个问题则更佳。
在你发送 BUG 前先回答下面几个问题,以确保你没有遗漏任何重要信息。
- 是否已阅读 文档?
- 是否在所提交的问题中包含了代码片段?
- 能重现该问题的明确步骤。
- 你当前所使用的 package 的版本号(这些信息位于
project.json
文件内)。 - 你当前所使用的操作系统。
- 你当前所使用的 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 所证实则只需测试;
- 如果处在一个非常难以测试的场景中,则无需测试之。
- 「非常难」这一定义取决于整个团队而言。