improved clarity & documentation