如何看懂api文档？

Question

有没有相关的课程可以学习，经常看api文档看的理解不对，尤其是那些缺少实例代码的。
例如下面这一段
http://docs.meteor.com/api/pubsub.html#Meteor-subscribe

Meteor.subscribe(name, [arg1, arg2...], [callbacks])
import { Meteor } from 'meteor/meteor' (ddp-client/livedata_connection.js, line 521)
Subscribe to a record set. Returns a handle that provides stop() and ready() methods.
ARGUMENTS

name String
Name of the subscription. Matches the name of the server's publish() call.
arg1, arg2... EJSON-able Object
Optional arguments passed to publisher function on server.
callbacks Function or Object
Optional. May include onStop and onReady callbacks. If there is an error, it is passed as an argument to onStop. If a function is passed instead of an object, it is interpreted as an onReady callback.

实际使用callbacks的写法应该是

Meteor.subscribe("name",{ onReady:function(){
//代码
}}

但是从文中的描述来看我根本想不到实际的写法应该是这样，不知道应该怎么理解。有没有系统的学习看api文档的教程？求教！