improved doc formatting