Web 技术研究所

我一直坚信着,Web 将会成为未来应用程序的主流

文档能解决哪些问题?

  大家经常会纠结一个东西没有文档无从下手,然而即使有了文档大家也会抱怨文档写得太烂看不懂。怪文档咯?如果文档真的解决所有问题的话,那还要人干嘛?想想学校里教的那些死知识,明明有教科书却还是需要老师授课,也就是说即使是很通用的文档也会有很多人看不懂。
  总是会有很多人看不懂或者不愿意去看甚至找不到文档,所以它并不能解决所有问题。文档这种东西需要有预期知识、概念,以及足够的经验同时具备才能看懂。比如连 HTML 都不知道是什么的人去看 CSS 规范的文档就会像看天书一样。或者即便知道 HTML,没有足够的开发经验去看 CSS 规范的文档也是看天书。
  确实有很多办法可以把看文档的门槛给降低,比如一些 tutorial 类的东西,因为它们本身表达的东西足够浅。如果是复杂的概念,确实没法把它们用简单的语言描述出来。因为复杂度就在那里是避不开的,就好像我们无法用简单的语言把复杂的数学知识描述出来一样。
  对于这些死知识,它们的表达方式确实可以一直优化下去,比如学校里的教科书都是经过优化后的表达方式。但是在实际生产中,很多知识是一直在改变的,比如软件版本等。文档也需要跟着知识一直做调整,但由于变化太快,文档的更新经常会跟不上速度。所以我们在遇到什么问题时候到网络上搜索一些解决访问,经常会发现不能用。那不是因为楼主傻逼,是因为知识在更新。
  我的观点是「文档是用来沉淀知识的,而不是用来普及知识的」。文档不需要所有人能看到,有人能看懂就行。如果需要普及知识,不如转发一条微博?
网名:
3.80.32.*
电子邮箱:
仅用于接收通知
提交 悄悄的告诉你,Ctrl+Enter 可以提交哦
神奇海螺
[查看全部主题]
各类Web技术问题讨论区
发起新主题
本模块采用即时聊天邮件通知的模式
让钛合金F5成为历史吧!
次碳酸钴的技术博客,文章原创,转载请保留原文链接 ^_^