notes recorded in README doc