improvement to implementation notes
part of last commit