cleaned up docs to use proper lists