Sunshine40

### Here’s another scenario: There’ an existing go package I’d like to import to my program, and (unsurprisingly) the doc is written in English. Although I myself can work with...

### Why don’t I try to fix/improve [golang-china/golangdoc](https://github.com/golang-china/golangdoc) metioned above? Well, key point is, I really hate the design of golangdoc, as it uses the modified version of package source...

### How would I expect it to be like for an ideal workflow of writing go doc with translations? 1. it should be backward compatible, so no “placing all language...

> However, that has tended to be UI text rather than documentation. I'm not sure if a translator who specializes in prose-style technical writing rather than UI text would have...

### When talking about the necessity of doc translation, no one can stay unbiased _(Warning: this comment is more or less complaining about the status quo, you can skip it...

@ehuss I'd like to work on this feature request. Would creating my own fork and making a new PR be the correct way to do this?

> 比方说南3局一本场我是南位，大家点数是10000,20000,30000,40000，我想知道这个点数分布情况下我完场时1位/4位的概率是多少 如果你把点数的指定扩大到一个区间范围，也就是能够筛选出曾经的对局当中符合你的条件的足够数量对局，那么数据本身是可以通过传统统计方式整理聚合的，但是需要大量的算力和存储空间，以及查询界面的UI复杂度。 这个需求的程序化描述是 【输入雀魂牌谱链接&你指定的条件（区间范围）】 【输出牌谱中对局针对你想要的条件判断真假&顺位结果】 然后针对你选取的数据集（如果你想选取的是自己账号的对局，那么牌谱屋已经提供了现成的牌谱链接列表），用上述程序进行批量处理。 这种耗费算力的程序显然不能够对一般用户开放，不然服务器开销会成倍上升。 所以你的选择是，自己写/参考他人开源项目改写一个这样的程序，然后爬虫获取牌谱链接，批量处理统计出结果。 如果你想为了研究目的，已经做好了统计相关的各种准备，仅仅需要更多牌谱链接作为数据源，那我相信作者大大不会不愿意向你提供举手之劳的帮助的。 > 按我的理解這個需求是需要用神經網絡估計的 如果需求是根据一个特定的场况（可以说严格匹配的条件下几乎匹配不到一模一样的场况），那么这种程度的预测程序必然需要用到人工智能预测算法，复杂度的确会更高。 @SAPikachu 顺便想了解一下，牌谱屋目前对牌谱信息的处理，能做到什么细节程度？ 如果给定牌谱链接，能否知道此战一共进行了多少小局，东1局的几家配牌，摸打手顺，牌山内容？ 我不是询问牌谱屋已实现功能当中是否有此类解析，而是说，以你已经进行过的工作经验，要做到上述信息获取，是否困难？

> 我不是询问牌谱屋已实现功能当中是否有此类解析，而是说，以你已经进行过的工作经验，要做到上述信息获取，是否困难？ 仔细一想，牌谱屋里已经有打点，和巡，向听，等等数据，这个问题的答案应该是肯定的，我有时间研究一下代码吧。

> 現在這邊是直接連接雀魂的 WebSocket 服務器獲取數據的，不需要經過模擬瀏覽器或者客戶端。 好的，我再仔细读代码学习一下，本身我对js构建复杂业务逻辑确实不熟悉（主要是对构建第三方业务涉及的逆向工程这块有畏难情绪） > a. shanten-core.js 由 https://github.com/EndlessCheng/mahjong-helper/blob/master/util/shanten_base.go 編譯而來 难怪如此，我第一个看的就是 shanten-core.js 属于是一发出货中大奖了。

> 我想的是用nonebot2来重构，直接使用nb2的指令响应逻辑 你说的是Rule/RuleChecker模式吗？这的确是强制把指令的响应后具体操作和响应的判断分离开来了。其实你可以考虑写一个平凡一点的指令模式，这种模式可能支持的格式比正则所能指定的模式更加受限，但是能够自动通过你的配置来摘取出一个使用样例。这是一种改进方向。 另一种改进方向，就是把命令使用方式的样例，和命令的响应逻辑（判断是否要响应，也就是Rule）写在一起。这个代码组织方式好不好呢？至少Rust和Go是这样做的，文档直接以注释的形式紧挨在代码逻辑旁边，改到逻辑的时候，自然而然就想到把文档也改了，那么最后能向用户展示的文档（说明书）也就自动被修改了——可以作为一种参考。 （其实.NET、Python的文档生成器也有类似功能，如果你使用过它们来自动生成文档，并且从整理后的文档作为一个独立的产物的视角来考虑，就会知道，代码块写注释不仅是给读你代码的人看的，还是给不读你代码的人看的。这样你就可以理解你的help字段所处的地位了） > 我只会想去实现设计，但如何实现设计总是缺乏考虑 这其实不完全是缺点，对于敏捷开发来说，你的行动很快，不像我总是会陷入过度设计，而实际的实现却迟迟不推进。 我也只是给你提供一些经过我个人过滤后认为值得提的点，至于最终设计，在开源项目里总是遵循谁出力多谁有发言权的简单原则。