renamed routes, added examples on AQL & route parameters 

& numbered examples 

Fixes #3