These are chat archives for LidiaSanchez/Normativa

4th
Dec 2015
Cristina Blanco
@CristinaBlanco
Dec 04 2015 11:33
En cuanto a la normativa, en otros foros han surgido ciertas ideas que voy a escribir aquí para seguir con la organización que tenemos de foros.
Ha surgido la idea de tener una plantilla para la documentación que debe entregar cada equipo/persona.
También la posibilidad de tener otra plantilla para la presentación final.
Roberto ha indicado que deberíamos tener todo el código comentado ya que todos debemos conocer todo el código. Se pueden indicar ciertas normas en cuanto a estos comentarios también.
A mi se me ocurre añadir lo de que el responsable oportuno fije fechas para entregas debatiendo todos sobre la fecha por supuesto
Estaría bien añadir también lo de ayudarse unos a otros en caso necesario que creo que no sea necesario indicarlo pero por si acaso mejor escribirlo, que lo escrito se lee.
En otros trabajos que utilizan esta metodología he visto que indican la obligatoriedad de que todos los mensajes sean contestados al menos una vez hasta que termine el debate o que cada X días todo el mundo debe entrar en los foros para actualizar las novedades. Son cosas que quizás nos parecen muy obvias pero que creo que si las escribimos como normas, nadie podrá "escaquearse" y la documentación del trabajo será mucho más completa que es algo que puntúa bastante la nota final
Cristina Blanco
@CristinaBlanco
Dec 04 2015 11:39
Otra cosa que se me olvidaba comentar, viendo que somos menos de la mitad, al menos por ahora, los que comentamos cosas aquí, creo que deberíamos seguir el consejo de Lidia de no esperar respuesta de todos, si no fijar un día límite para responder y fijar lo que se haya dicho hasta ese momento
Iván de Paz Centeno
@ipazc
Dec 04 2015 14:27
Creo que sería conveniente realizar una pequeña guía de estilo de cómo comentar y escribir el código, una guía que no sea extensa ni sature, que fije claramente alguna pauta a seguir para comentar y ordenar el código. Eso facilitará la tarea de leer código de otros, porque sabremos qué estructura nos vamos a encontrar.
Cristina Blanco
@CristinaBlanco
Dec 04 2015 15:24
Tengo la guía de la documentación, drive o dropbox? que preferís?
en cuanto a la guía del estilo de comentar... que estilo os gustaría? yo creo que como mínimo en cada método nuevo que se implemente, indicar qué hace el método y describir los parámetros de entrada y salida. Por cada bucle quizás también reflejar qué hace el bucle. Y por último se me ocurre añadir en cada nueva variable creada indicar para qué sirve o que datos va a almacenar, creo que esto de cara a MPI que requiere muchas variables puede venir bien