documentation improvements and layout fixes