revised doc formatting