var. naming; code comments; changed dots styles

var. naming improvements;
commented the code;
changed some suggested styles.