updated variable name and added more comments as per @ehebert's PR notes.