document the secondary hierarchy

Signed-off-by: Mattias Andrée <maandree@operamail.com>