Issue
一、什么是Issue
Issue是GitHub、Gitee等上用于记录问题、bug、任务、需求等的地方。
二、为什么使用Issue
Issue实际上是一系列与仓库有关的讨论集合,它可以用来记录问题、bug、任务、需求等。他和QQ、微信等不同,它是一个公开的讨论区,任何人都可以参与讨论。同时,还可以搜索到前人的讨论,方便我们学习。
同时,他也是像邮件一样,具有低频交流的特性,这就使得不管是提问还是解答,都得描述的相较仔细。且最好图文并茂。大大减少无效交流。
三、如何使用Issue
首先,目前我们只支持Gitee的Issue功能,所以请先注册一个Gitee账号。
然后在TouchSocket Issues 连接下,新建Issue即可。
提示
在填写时,请尽可能的描述清楚现状,及其他一切有关信息。最好能提供可运行测试的demo。
警告
未按格式提供的Issue,会被直接关闭。一般建议使用电脑端编写。因为我们已经为大家写好了相关模版。
四、提供Issue有关的Demo
在Issue中,我们强烈建议提供可运行的demo,这样可以帮助我们更快的定位问题。
提供的方式仅限下列git仓库,其余途径均不受理。
4.1 Fork仓库
首先,点击Fork,将仓库克隆到自己的名下。
然后,在仓库中,新建一个文件夹,名称按照序号,依次递增,要求不重复。然后在此文件夹中新建一个demo解决方案,就是能直接编译运行的。
4.2 提交
当建立好demo后,将demo提交到自己的仓库中。请确定此Demo可以脱离环境编译并运行。
4.3 合并PR
在提交以后,在gitee上,点开自己Fork的仓库,然后点击Pull Request
,新建Pull Request
。
然后注意,选择目标分支为RRQM_Home/publicworkbook=>master
。同时,请填写相关信息。
最后,所提的Issue中,提供此demo的链接。