docs with clearer formatting