Viendo las consignas del TP veo que dice:
"Código- ¿Respeta estándares de codificación?
- ¿Está correctamente documentado?"
Mi pregunta es: con correctamente documentado se refiere a que cada metodo debe tener escrito todas sus postcondiciones y precondiciones? O se refiere mas bien a los comentarios en caso de falta de claridad?
Hola Axel,
No, en Pharo la documentación de las clases tiene un lugar especial y se accede haciendo click en el signo de admiración rojo que aparece a la izquierda del nombre de la clase. Se suele poner una descripción breve de la clase, su principal responsabilidad y quizás mencionar algunos de sus mensajes más importantes. Ahí mismo te aparece una plantilla para sobreescribirla.
De todas formas esto es un detalle de prolijidad y lo menos importante del TP. Si el resto está perfecto esto no afectaría la nota. Creo que esto responde la pregunta 7 de tu cuestionario.
Acerca de los comentarios, se espera que haya la menor cantidad posible (idealmente ninguno). Las pre- y postcondiciones quedan definidas en tus pruebas unitarias, así que no hace falta escribirlo aparte. Y si en alguna parte ves la necesidad de escribir un comentario porque el código no está claro, entonces lo más probable es que el problema sea el código. Si el código tiene una nomenclatura adecuada, las clases tienen pocas responsabilidades y se hace buen uso de delegación y de herencia entonces en ningún momento el código debería necesitar una aclaración.
Saludos,
Tomás
buenisimo gracias