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

This is following up of #35. 
s/rectangle/the rectangle/