notes on working with this code as a package