readme link error and more comments