restructured documentation for aliases + changed few examples

Signed-off-by: Dominik Richter <dominik.richter@gmail.com>