update implementation notes