comments on naming conventions

added some comments here to help explain the naming conventions