documentation

documentation and some coment adjustments related to it