moved some commentary out of package-info into README