can we add some code documentation about this. why do we need it. what is it doing. etc.