2.7K Star 16K Fork 3.6K

GVPLayui / layui

 / 详情

📣 重要调整:Layui Issues 请统一在 Github 提交

待办的
拥有者
创建于  
2023-12-15 20:52

为了加强 Issue 规范、提升沟通效率,Layui Issues 已统一在 Github 受理:

https://github.com/layui/layui/issues

背景与现状

自 2021 年 Layui 将日常维护及社区集中转移到 Github 和 Gitee 以来,Github 承载了 Pull Request 的工作,而 Gitee 则承载了 Issues 的工作,前者主要面向项目贡献者,后者则面向于全体 Layui 受众。之所以这样拆分,一方面是考虑到网络问题,还一方面则是基于我本人对 Gitee 的情感因素,尤其是开源中国及 Gitee 长期以来对 Layui 的分外关照,让我无不想着也给 Gitee 平台一些回馈,如引导 Layui 用户前往 Gitee 发表议题、交流技术等,为平台的品牌宣传和用户活跃度略尽绵薄之力。

随着时间的推移,Layui 在 Gitee 社区的良好氛围,吸引了包括 @sunxiaobin @morning-star 等许多顶尖的开发者,加入到这项崇高而又稍显卑微的开源公益事业中,他们在 Github 和 Gitee 来回穿梭,为不同层次的 Layui 受众耐心提供各种解决方案,他们的努力极大地鼓舞了我对项目的热情,也使得在整个 2023 年 Layui 的版本迭代有序推进。贡献者投入的精力,让我既感动又心疼,我曾在一篇高质量的 Issue 中这样回复:

Layui 从过往的喧嚣中走来,偏居前端之隅,拾柴者们凝聚的温暖依旧,而行者匆匆,还能被谁所洞见…

这是一种复杂的内心写照,我希望提问者都能得到帮助(虽然他们总是来去匆匆),但也为贡献者投入的巨大精力而百感交集,他们的努力,又是否真的能被提问者所看到、所感受到?

尤其最近,越来越多的低级问题和不规范的 Issue 充斥着社区,尽管我们不断完善相应的 Issue 规范,但仍然在无效的沟通中耗费大量的时间,有时甚至只是为了获得提问者的一个「最小化的重现」。因此,为减少不必要的社区资源消耗,进一步严格要求 Issue 规范已势在必行。尤其对于核心维护者,应当让他们的主要精力投入到项目更重要的工作中去。

接下来的调整

首先要重申的是,Layui 对 Gitee 平台具有深厚的情感和尊重,我与贡献者们,也多次通过各种渠道建议平台加强 Gitee 社区版的 Issue 管理、流水线、Bot 等功能支持。但平台也存在优先级考量,我们深表理解。所以在此声明:以下调整是基于我们对加强 Issue 规范的迫切需求,与我们对 Gitee 平台的看法没有任何关系。

接下来,Layui 的社区维护将做出如下调整:

  1. Issues 将统一在 Github 进行受理。同时,考虑到 Gitee 既有的 6000 多条 Issues 存在大量可供参考的内容,我们将在 Github Issues 的创建入口保留 Gitee Issues 的通道,便于大家前往搜索。
  2. Issues 将只接受「Bug 报告」和「新功能请求」,原则上不再接受用法和功能疑惑等业务相关的问题。针对这点,在引导大家查阅文档和搜索相似 Issue 的前提下,我们也将在 Github 开启 Discussions 供大家进行技术交流。
  3. Issues 将逐步加入 Github Actions 进行管理,严格规范议题。

以上调整将于 2023-12-31 之前全部完成。

此外,Layui 在 Gitee 的仓库将主要作为镜像存在,会继续同步版本代码和发行版资源,但不作为社区承载。这里要再次感谢 Gitee 尤其是 @诺墨 一直以来对 Layui 提供的大量帮助。同时,也推荐大家将私有项目托管在 Gitee

此次调整,旨在为项目提供一个更加稳健和良好氛围的社区环境。
更多细节可详见:🍀 Layui Issue 规范指南

评论 (9)

贤心 创建了任务
贤心 添加了
 
动态
标签
贤心 修改了描述
贤心 修改了描述
贤心 修改了描述
贤心 修改了描述
贤心 修改了描述
贤心 修改了描述
贤心 修改了描述
展开全部操作日志

支持,开源项目是关于共同建设,而不是仅仅依靠维护者的努力。希望大家都能严格遵守 Issues 规范,共同打造一个更好、更健康的社区氛围。

贤心 修改了描述
贤心 修改了描述
贤心 修改了描述
贤心 修改了描述
贤心 修改了标题
贤心 修改了描述
贤心 修改了标题
贤心 修改了标题
贤心 修改了描述
贤心 修改了描述

上面的文章稍微有点长,可能有些同学未必能完全阅读。

那么,为什么一定要将 Layui Issues 由 Gitee 转移到 Github?主要遇到两点困难:

  1. 搜索的困难:Gitee 无法进行全文、评论等多维度关键词检索,这就意味着,尽管 Layui 在 Gitee 有数千条 Issues 沉淀,但要从中找到有效的内容参考,非常不易。我尝试通过 label 的方式归纳一些 FAQ,但始终还是需要肉眼去找。这一点,此前也有贡献者向 Gitee 提了需求(见:#I8IDMA),但未被重视,或者说暂时难以推动。
  2. 自动化管理的困难:在过去,我们把 Gitee Issues 作为普通社区简单用用是没问题的,但随着太多的初级和重复的议题不断出现,低效的沟通问题日渐明显,导致维护者的精力被持续大量地消耗。因此,借助自动化的管理,去建设良好的规范和行为准则是迫切且必要的。而相比 Gitee Go,Github Actions 更能满足当下的需求。

总而言之,同时管理两个平台困难很大,基于对项目的长远考虑,做出本次调整。
此评论是考虑到本月底不再受理 Gitee 平台的 Issue 后可能造成的用户疑惑,故作提前解答。

没错!gitee issues的搜索功能仍然任重而道远,为了找到需要的内容,往往需要不断尝试搜索词,无果!最后只能一条条挨个找!

贤心 修改了描述

并不是很正确的选择。
肯定是很无奈的选择。
无条件支持。

多的不说,支持!支持!支持!支持! :+1: :+1: :+1: :+1: :+1: :+1: :+1:

理解本次调整!头疼的是Github的访问时好时坏,这就需要借助工具来稳定访问了,推荐FastGithub、DevSidecar、Watt Toolkit(原名Steam++)。

Github的搜索依然不是很好,最后也需要一条条的去看。而且最重要的问题是,国内访问起来很慢,经常打不开。

很遗憾,我们这里github是被墙的。

最近收到不少因为打不开 Github 而无法提 Issue 的私信,我难以详细地回复这个问题。

或许这是一道关于理解与克服困难的课题。

前面也有热心小伙伴的相关回帖可作为参考。

登录 后才可以发表评论

状态
负责人
里程碑
Pull Requests
关联的 Pull Requests 被合并后可能会关闭此 issue
分支
开始日期   -   截止日期
-
置顶选项
优先级
参与者(8)
7407590 starsatdawn 1700900251 92529 sentsin 1578917144 347163 lsl1618 1578920825 8963259 cvpv 1618226243 591374 solomon zjf 1578928552
JavaScript
1
https://gitee.com/layui/layui.git
git@gitee.com:layui/layui.git
layui
layui
layui

搜索帮助