shorter max titles
large documentation update