added comments to framework files to make it more comprehensive