updating to help understanding of documentation