added doc explainations