update of guide - formatting and headers