refactor spans.js and add description about timeline annotations to doc

This is following up of #35. 
Yeah, drop this and just say the line above.