added notes for implementation