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

This is following up of #35.