added annotations to most files