Some method naming tweaks and documentation for naming convention