Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

"麻将牌 JSON"的表达可能有失妥当 #19

Open
Water-Buckets opened this issue Aug 28, 2024 · 2 comments
Open

"麻将牌 JSON"的表达可能有失妥当 #19

Water-Buckets opened this issue Aug 28, 2024 · 2 comments
Labels
documentation Improvements or additions to documentation

Comments

@Water-Buckets
Copy link

"麻将牌 JSON"或"Minecraft style json"似乎并不是一个合适的说法. 更加精确的来说, 在Minecraft 中它被称为"SNBT格式".
使用"麻将牌 JSON"这样带有戏谑意味的词的确是可以理解的, 这确实体现了幽默感. 但是 MCDR 作为一个被广泛接受的服务器工具, 它的插件系统中包括了许多插件, 这其中有相当一部分插件都使用了您的MinecraftDataAPI. 考虑到其被广泛的使用, 这样的名字可能带来困惑. 考虑到大部分插件作者的技术以及认知水平, "SNBT"可能是一个更加合适的选择.
当然, 仅仅因为一个有趣的名字而改动 API 是不合适的, 相比更加有用的工作, 改动这个名字也没有那么重要. 以上内容请您参考.
最后, 也非常感谢您为 MCDR 的生态所做的贡献.

@Fallen-Breath Fallen-Breath added the documentation Improvements or additions to documentation label Aug 28, 2024
@Fallen-Breath
Copy link
Owner

考虑到其被广泛的使用

这里出现了偷换概念的行为。前文是以用户的角度来描述 MinecraftDataAPI 的使用范围之广,而本 issue 所描述的用词是位于面向插件开发者的 API 文档中,是面向开发者的。将面向用户的“广泛”定语应用到开发者的文档上,是存在概念偷换的。广泛使用本插件的普通用户并不能感知到开发者文档中的这一用词


回到这一 issue,若认为“麻将牌 json”这一表述存在含糊不清的,我之后可以将相关用词改造成指向 mc wiki 的超链接,这样也不会出现表述不清的现象

@Water-Buckets
Copy link
Author

考虑到其被广泛的使用

这里出现了偷换概念的行为。前文是以用户的角度来描述 MinecraftDataAPI 的使用范围之广,而本 issue 所描述的用词是位于面向插件开发者的 API 文档中,是面向开发者的。将面向用户的“广泛”定语应用到开发者的文档上,是存在概念偷换的。广泛使用本插件的普通用户并不能感知到开发者文档中的这一用词

是的, 我的本意是有许多插件都将 MinecraftDataAPI 作为依赖, 是插件开发者使用的较多. 确实我的表述存在问题.


回到这一 issue,若认为“麻将牌 json”这一表述存在含糊不清的,我之后可以将相关用词改造成指向 mc wiki 的超链接,这样也不会出现表述不清的现象

如果能修改原有的函数名是最好不过的了. 但是作为一个被开发者广泛使用的插件, 仅仅修改文档也是合理的.

附:
SNBT格式
教程:SNBT
教程:NBT命令标签

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants