感动, 这位粉丝给 gws 源码几乎每一行都写了注释 !

[Nazz]

GWS 注解版 https://github.dev/shengyanli1982/gws/tree/dev

简介

GWS 是一个用 Go 编写的非常简单、快速、可靠且功能丰富的 WebSocket 实现, 它内置了压缩上下文接管, 代理, 广播 并发限制等等一系列实用功能, 您可以轻松编写自己的服务器或客户端。

[weakish]

// 设置元素的值
// Set the value of the element
ele.value = value

// 执行将元素推到队列尾部的操作
// Perform the operation to push the element to the back of the deque
c.doPushBack(ele)

// 返回该元素
// Return the element
return ele

如果不是機器輔助生成的，真是好有耐心。
有種坐飛機，同樣的內容用出發地語言、目的地語言、英文三種語言分別播報一遍的感覺。

[Nazz]

@weakish 即使有 AI 辅助, 也肯定人为校准过, 非常费心了

[sleepm]

链接是 .dev 你确定不是你自己么

[jevonszmx]

@weakish 这注释写了等于没写吧

[panlatent]

这种注释算不得好注释，不如没有，去掉后不影响我阅读代码，反而把 3 行的东西便成了这么多行，意义何在？

[Nazz]

@jevonszmx 因为一小片代码的注释就否定所有工作, 以偏概全了

[Nazz]

@sleepm 我不理解你的推理逻辑

[jptx]

@sleepm github.dev 是 github 官方的，使用 vscode 浏览代码用的，你在 GitHub 任何一个仓库页面按键盘上的 [.] 键即可打开，建议体验一下

[ElmerZhang]

具体观点我就不发表了，说出来不太好听。

[herozzm]

@panlatent 同意，就 op 发的代码来说，这些注释无意义

[Nazz]

@panlatent 哈哈, 有点过于详尽了. 如果在快速迭代阶段, 我会大片删除函数内的注释, 不过现在代码仓库主干已经非常稳定了, 应该不会再有重大更新, 接受 PR 就当表彰粉丝的热情了.

[mars2023]

@herozzm #10 不仅 op 发出来的代码；简单看了 client 的代码。
这个中英文注释还真不如没有注释，真的很影响阅读代码。
谁家的注释是这样子写的！！

[deplives]

@sleepm 魔怔了吧

[lmw2616]

用 ai 生成的吧

[ryougifujino]

泼个冷水，个人感觉这并不是什么好的做法。真正好的代码应该在简单的地方做到使用命名进行自注释，在复杂有必要的地方才进行注释。每一行都进行注释反而增加了噪声会影响阅读。

[cinlen]

```
// 返回客户端连接、HTTP 响应和错误信息
// Return the client connection, HTTP response, and error information
return client, resp, err
```

建议 revert 掉这个 pr

[EchoWhale]

这种注释没必要, 只会把仓库变成屎山, 迭代几次后, 到处都是注释和代码不一致的逻辑

[ala2008]

浪费存储和无效阅读

[pkoukk]

好的代码是能 self explain 的，注释有且只有重要的地方需要写
写在这些无关紧要的地方，你以后改代码，这里的注释改不改？

[xuelu520]

注释不是越多越好，很多无效注释还会影响阅读，建议 revert 掉这个 pr