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. 使用手册
  • 工作时放在手边随时查阅的文档,内容全面,语言精炼高效,适合忘记某个参数时快速查阅使用方法

当前网速较慢或者你使用的浏览器不支持博客特定功能,请尝试刷新或换用Chrome、Firefox等现代浏览器