docs(core): improve documentation.

Closes #1526
Closes #1525
doc(routing): minor routing documentation fixes
doc(annotations): fix typos