- make some links into the reference documentation relative for   off-line readers - fix some minor typos and markup errors
- make some links into the reference documentation relative for
  off-line readers
- fix some minor typos and markup errors

sk-/python2.7-type-annotator,sk-/python2.7-type-annotator,sk-/python2.7-type-annotator