improved the design
added more details to what is happening