Por estas dos razones, se vuelve incomodo meterse al codigo cada vez que quieres ver como funciona algo, o que funcion debes utilizar. Claro, un buen codigo es entendible, sin embargo, es mucho mas util tener una documentacion aparte que te describa basicamente: la estructura de tu clase, una descripcion de para que sirve, y una tabla de sus metodos y propiedades con su respectiva descripcion. No es necesario documentar cada linea de codigo tampoco, pero tener una buena documentacion de tu codigo te ahorra un monton de tiempo.