added some comments on conventions