关于学习ASP.NET Core 我有一些话要说……

风水及命理大师

对 看到推荐看官方文档的我就想打人 写的啥屁内容 简单的讲的屁屎尿流 难点的讲的云里雾里 根本不想看

人生有迹

错别字，作者

神仙难觅

云里雾里可能是机翻的锅

优饰格曼曼

不光是跟其它家的比，就是自家的.net，全球最好的文档还是在微软。。。十几年积累没的挑啊。。。。
不过准确的说，你指的这个叫作教程比较恰当，文档是指的那些具体类库里所有东西的描述说明，比如 .net 里这个随机数的文档
https://docs.microsoft.com/zh-cn/dotnet/api/system.random.next?view=netcore-3.1
有时候项目可能就是需要了解清楚使用的一个函数它具体是什么，而不是在最后就听对方丢一句“自己看源代码”。
另一个能让我感受到文档做的好的是PHP自身的文档，算是比较事无巨细的，但PHP本身的设计就有点不太给力了，比如PHP经常就是有函数给你一个参数，类型就是什么都能输入，这就**头大。

PS：让使用者自己看源代码是非常恶劣的行为。。

邢雨

没错，不说了，我去追视频了
[欢呼]

让我留在你身边

所以……冲着那句PHP是世界上最好的语言 我也就不想学了233 感谢指正，我修改下文章。教程是教程，文档是文档；微软的API文档确实是超好的

兴博

[捂脸] 你要说这个叫“教程文档”也没错，但我觉的这种跟sdk文档（我链接发的那种，大概叫这名？）最好是区分一下。开源项目和中文社区大多都不注重后者。

一鹰

官方的API文档也有点一言难尽，几个月前突发奇想准备写个efcore db provider的，结果官网api文档么没有，源码里面全是没用的注释。。心情复杂

方小胖

.....

朝暮青丝

微软写文档是工作是okr，毕竟谁都想摸鱼，遇到问题下边留言或是提issue。微软有个绩效是客户提了ticket之后自己点已解决。这其实就是看帮助文档写的好不好，用户能不能自己解决问题。
实话讲msdn虽然很全，但是不系统，就是想到就添一点。微软文档还有个问题，一个内容，到处都是，还有些许不一样，都不知道看哪个。