added notes for re-organisation of code