tweaking doc format for readability