initial PR notes by @JonRowe and @xaviershay