update notes on documentation; and include in release