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

This is following up of #35. 
If you see a small red rectangle, hover over it to see a timeline annotation (Does this happen if you hover over it?  I've not tried)