首页 > 思索 > 话说官方文档
2014
06-16

话说官方文档

近期学习和使用了很多新技术,由于都是新兴技术,网络上资料并不多,官方文档全是英文。奈何自身英语能力太差也只能硬着头皮去啃官方文档了,如下列出一些对官方文档的一些看法,与大家分享。如有建议,欢迎提出。

文档的价值
文档是产品的说明书,往往是产品的第一手资料,其价值不言而喻。

文档的作用
全方位了解产品,比如说创作背景、创作团队,技术架构、使用条件、所需使用平台等等。

文档的学习利用
不同产品的文档架构组织不同,叙事的方式也不尽相同(不完全相同),如果是小白用户就要尽量做到全部阅读,尤其要按照从前往后的顺序,如果不是小白用户,关注自己需要关注的部分即可。

文档的学习基础
坦白说,有些文档的阅读是需要对产品有一定理解的,否则会很难理解某些说法。很多时候,某个技术产品是需要其他相关技术的,这时候就要先弄明白那些相关技术,再去学习那个技术产品,否则学习起来会非常困难,也很容易打击学习的信心

文档中的错误
官方文档中有错误也很正常,毕竟不是出书,没有那么长时间的准备。但是对于小白用户来说,这无疑是灾难。人无完人,文档中出现错误也是很正常的一件事,所以大多数的网站都会提供论坛,你可以去论坛上看一下你所发现的“问题”是否是一个错误,也可以在论坛上提出来大家共同讨论和解决。

最后编辑:
作者:小马哥
大数据技术学习及实践者~

留下一个回复

你的email不会被公开。