C#是不是都只能看源码,不提供文档

2021-11-07 20:25:00 +08:00
 liuser666
先声明我是 C#的新手,保命。

想用 yaml 来做桌面的导入数据和配置文件,有个库叫 yamldotnet,它的官网就给了几个例子。

我的需求是解析 yaml 文件嘛,相关的官网只给了一个 Loading a YAML Stream 的例子.

看了半天才把几个 Class 的定义吃透,这是普遍现象吗?

难道我用一个包都得扒源码才能弄明白这个类是干嘛的吗?....后端都这样吗?太可怕了...
3590 次点击
所在节点    程序员
26 条回复
leeg810312
2021-11-08 20:38:28 +08:00
@x940727 .net 和 JAVA 我都看过文档,官方英语文档质量差不多,但微软有自研的 AI 翻译,可以官方直接提供较高质量机翻的技术文档,主要类库 API 看中文也没有问题,适合不懂英语的开发人员
rioshikelong121
2021-11-08 21:43:10 +08:00
@cpstar 实际上来说编写良好的 sample 能覆盖大部分的简单场景,这就是 sample 的价值之所在。如果 API 设计的和你说的非得看源代码才能用,那说明抽象已经泄漏了,也说明这个轮子造的有问题。
wxw752
2021-11-08 23:44:36 +08:00
@leeg810312 #21 前几天被迫写客户端,我算是体会到了这个"较高质量"的机翻,都是泪。。。
kelo6
2021-11-09 09:27:36 +08:00
生态不行啊
0o0o0o0
2021-11-09 09:40:25 +08:00
@wxw752 比直接谷歌翻译好很多
leeg810312
2021-11-09 10:42:00 +08:00
@wxw752 我看英语文档无障碍,但还是得考虑有人需要中文文档,虽然机器翻译有点生硬,但结合样例代码可以满足大多数需要

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/813689

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX