Updated docs & comments for more clarity.