added notes to the framework