Guide、Manual和Tutorials的区别
开源技术的官方网站提供了许多指导文档,理解他们的真正含义,会有事半功倍的效果。
Tutorials
Tutorial
- n. 个别指导
- 对一个关键点的指导文档,一个Tutorial只教会一个关键点
- 例如,如果你在scala公开课的wiki(实现团队协作编辑网页和文档共享的网站)上看到Eclipse tutorial,那么这个教程将教你如何在eclipse上开发scala项目,有时点到Hello World为止,仅此而已,不会介绍更多的eclipse使用方法。
Tutorials
- Tutorial的复数形式,即众多的知识点教程的集合
- 例如,scala官网文档Scala Tutorials的目录,罗列了许多scala的关键知识点的指导教程,不像Guide会分章节。
所以,Tutorials文档有点对系统中各个知识点逐个击破的意味。
Guide
Guide
- n. 指南;向导;入门书
- 指导作用且对技术的理解有帮助的文档,可以理解为国内常用的“从入门道精通”,通常先解释技术原理,然后指导使用方法,适合学习
官网的Guide是很重要的学习资料,随软件或语言版本及时更新,也是最权威的指南!英语不好的同学可以google Guide的中文翻译,比如,找“Spark Programming Guide”中文翻译,可以搜 “Spark” “编程指南”,但是一定要注意翻译对应的版本是否和你的软件版本一致。
Manual
Manual
- n. 使用手册
- 工作时放在手边随时查阅的文档,内容全面,语言精炼高效,适合忘记某个参数时快速查阅使用方法