Github 提交 issue 的正确姿势

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: 最近 Fair 社区一直比较活跃,每天都能收到好几个 issue 的提交。

最近 Fair 社区一直比较活跃,每天都能收到好几个 issue 的提交。

在我看来,解决 issue 本身是一件很快乐的事情,因为可以直面用户的问题和需求,与用户直接沟通。

解决 issue 还有一个好处是,可以推动你进行自我反思,思考项目中哪些方面可以进一步优化,以方便开发者使用。

比如,经常会收到一些重复,且都是属于很基础的使用问题的 issue,那我是不是可以通过丰富日志输出来规避这类问题呢?

在日志里把自查步骤,以及 Fix 建议打印出来,那么开发者就能按照指示去解决,而不用再去提交 issue,省时省力。

当然,如果有一些问题必须要提交 issue 的话,那么就涉及到今天要聊的话题了:怎样正确地提交 issue。

通常来说,维护得好一点的开源项目,都会在 issue 的提交里为开发者创建好模板,开发者只需要按照模板的格式填写内容,然后提交即可。

但是,从实际的情况来看,20 个人提交 issue,往往只有 1 个人愿意按照模板格式填写 😂。

更糟糕的是,提交的 issue 内容,也不按照 Markdown 的格式编写,读起来很头痛。

最常见的就是,帖代码的时候,直接用文本格式进行提交。有的把代码和日志信息放到一块进行提交,需要先肉眼识别出,哪块是代码,哪块是日志信息,然后再开始分析问题。

如果想让自己的 issue 得到快速的响应和解决的话,其实只需要把自己的 issue 内容稍微优化一下即可。

一般来说,提交 issue 时,以下几点是必须的:

1、贴出自己的本地环境信息

环境信息有助于排查问题和定位问题,开发环境一致才有助于复现问题。

2、代码一定要使用 Markdown 格式提交

如果你要贴的代码超过了一行,请一定使用 Markdown 格式提交。

换位思考一下,你愿意阅读 Markdown 格式的代码还是文本格式的代码。

3、复现步骤

如果操作步骤比较复杂,可以复述一下复现步骤,有助于快速帮你定位问题。

提交 issue 本身是一件小事情,但是从这件小事情中,可以看出一个人平时的开发习惯、思考习惯,以及与人合作的态度。

所以,别偷懒。

相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
相关文章
|
3月前
|
设计模式 Java 测试技术
【Selenium使用误区】Iframe元素定位失败:避免误提GitHub Issue的技巧
本文分享了作者在使用Selenium进行UI自动化测试时遇到的一个常见问题:在模拟登录163邮箱的过程中,元素定位失败,原因是没有正确地定位到iframe内的元素。文章通过分析问题原因、提供解决方案和附录代码,指导读者如何避免类似的错误,并强调了在UI自动化测试中准确定位页面元素的重要性。
35 1
|
SQL 机器学习/深度学习 JSON
钉钉/企业微信机器人:“Github触发器”与“Issue机器人”
众所周知,在Serverless领域中,触发器是FaaS必不可少的一部分;一个FaaS平台,他的触发器数量、质量以及类型,很可能会决定这个FaaS平台是否能成为“主流”平台;因为触发器不仅仅是一种功能的体现,更是解决普遍性业务诉求的一个重要途径;目前来看,各个云厂商所提供的触发器基本上都会包括API网关触发器、对象存储触发器、时间触发器等,当然也有厂商提供一定的消息触发器、日志触发器、甚至是一些SQL相关的触发器、CDN触发器等,那么在我们的实际生产生活中,这些表面上看起来“很基础”的触发器,是否可以升级成为一个有趣的“高级触发器”呢?
689 0
|
前端开发 JavaScript 程序员
用GitHub Issue取代多说,是不是很厉害?
摘要: 别了,多说,拥抱Gitment。 2017年6月1日,多说正式下线,这多少让人感觉有些遗憾。在比较了多个博客评论系统,我最终选择了Gitment作为本站的博客评论系统: UI简洁,适合我的博客风格 使用GitHub账号登陆,适合技术博客 使用GitHub Issues写评论,符合程序员的习惯 1. 注册OAuth Application 因为Gitment使用了GitHub的服务,因此需要注册OAuth application。
886 0
|
1月前
|
编解码 Oracle Java
java9到java17的新特性学习--github新项目
本文宣布了一个名为"JavaLearnNote"的新GitHub项目,该项目旨在帮助Java开发者深入理解和掌握从Java 9到Java 17的每个版本的关键新特性,并通过实战演示、社区支持和持续更新来促进学习。
70 3
|
3月前
|
Rust 前端开发 JavaScript
Github 2024-05-20 开源项目周报 Top15
根据Github Trendings的统计,2024年5月20日当周共有15个项目上榜。按开发语言分类,项目数量如下:Python项目5个,TypeScript项目3个,C++项目2个,Jupyter Notebook项目2个,C、Go、Rust和C#项目各1个。介绍了多个值得关注的项目,包括ChatGPT桌面应用程序、Fooocus图像生成软件、Jellyfin媒体系统等。这些项目涵盖了多种功能和技术领域,值得关注和研究。
56 3
|
3月前
|
SQL JavaScript 前端开发
Github 2024-08-05 开源项目周报 Top15
根据 Github Trendings 的统计,本周(2024年8月5日统计)共有15个项目上榜。以下是根据开发语言汇总的项目数量: - Go 项目:4个 - JavaScript 项目:3个 - Python 项目:3个 - Java 项目:2个 - TypeScript 项目:2个 - C 项目:1个 - Shell 项目:1个 - Dockerfile 项目:1个 - 非开发语言项目:1个
92 2
|
3月前
|
人工智能 Rust JavaScript
Github 2024-08-26 开源项目周报Top15
根据Github Trendings的统计,本周共有15个项目上榜。以下是按开发语言汇总的项目数量:Python项目8个,TypeScript、C++ 和 Rust 项目各2个,Jupyter Notebook、Shell、Swift 和 Dart 项目各1个。其中,RustDesk 是一款用 Rust 编写的开源远程桌面软件,可作为 TeamViewer 的替代品;Whisper 是一个通用的语音识别模型,基于大规模音频数据集训练而成;初学者的生成式人工智能(第2版)则是由微软提供的18门课程,教授构建生成式AI应用所需的知识。
122 1
|
3月前
|
Rust Dart 前端开发
Github 2024-08-19 开源项目周报Top15
根据Github Trendings的统计,本周(2024年8月19日统计)共有15个项目上榜。按开发语言分类,上榜项目数量如下:Python项目最多,有7项;其次是JavaScript和TypeScript,各有3项;Dart有2项;HTML、PowerShell、Clojure和C++各1项。此外,还介绍了多个热门项目,包括Bootstrap 5、RustDesk、ComfyUI、易采集、Penpot等,涵盖了Web开发、远程桌面、自动化测试、设计工具等多个领域。
106 1