update html comments and readme to match new structure