add comments and update variable names for clarity
add comments and update variable names for clarity

fritx/friends,absullivan/friends,joeynimu/friends,halink0803/friends,joeynimu/friends,IQ2022/friends,LinusU/friends,IQ2022/friends,webcoding/friends,halink0803/friends,webcoding/friends,ekmartin/friends,fritx/friends,Flet/friends,absullivan/friends,LinusU/friends,bright-sparks/friends,ekmartin/friends,Flet/friends,bright-sparks/friends