La redaccin de un informe de prcticas v2.

0
Hernando Silva Varela hernando@usal.es 23 de febrero de 2006 1. INTRODUCCIN La redaccin de un informe de prcticas es uno de los problemas a los que se enfrentan los alumnos que deben entregar los resultados de su trabajo para la evaluacin por parte del profesor. En este documento se describe de manera breve un formato sencillo para el informe escrito que deben presentar los alumnos junto a los programas de ordenador que se les solicitan. Todo informe debe llevar en la primera pgina un encabezado que indique el nmero de prctica de la que se trate as como su ttulo. Por ejemplo: PRCTICA 1 DE ESTRUCTURA DE DATOS: VECTORES, MATRICES Y MEMORIA DINMICA. A continuacin, deben aparecer los nombres de los alumnos que realizaron la prctica y el correo electrnico de al menos uno de ellos. Otro dato importante es la fecha de realizacin o entrega del reporte (informe). Enseguida deber aparecer la primera seccin del informe. Esta seccin ser titulada regularmente INTRODUCCIN y contendr una breve descripcin de la temtica sobre la que se desarrolla la prctica y algunos aspectos tericos que pudieran ser de inters. Por ejemplo, si la prctica versara sobre vectores, matrices y memoria dinmica, sera conveniente mencionar en la introduccin algunos conceptos tericos sobre ese tipo de estructuras, as como algunos aspectos relevantes que tuvieran que ver con lo que luego se har en la prctica. Tambin se podra incluir en esta seccin una breve descripcin de lo que se intenta hacer en la prctica De cualquier manera, no se aconseja que esta seccin supere la longitud de una pgina. 2. DESARROLLO La siguiente seccin que debe aparecer en el reporte es la de desarrollo de la prctica. Generalmente, lo que se solicitar en las prcticas ser el diseo, implementacin y evaluacin de uno o varios programas. En esta seccin se describe de forma textual, esquemtica o en pseudocdigo, la forma en la que se han diseado, organizado e implementado los programas. Para esta versin, se ha considerado conveniente introducir algunas modificaciones tales como: a) Ser indispensable que el alumno presente un diagrama de flujo de los programas que ha diseado. Existe software gratuito de buena calidad para el diseo de estos diagramas. b) No se admitir que el alumno presente directamente cdigo (fragmentos de programa) en el reporte, a menos que sea absolutamente indispensable. En general, la seccin de desarrollo suele ser la ms extensa del informe.

3. PRUEBAS Es aconsejable incluir a continuacin una seccin de pruebas para presentar ejemplos del funcionamiento de los programas. Estos ejemplos podran constar simplemente de algunos casos de ejecucin bajo las circunstancias que los alumnos consideren pertinentes a fin de mostrar el funcionamiento del programa, o incluso alguna anomala o mal funcionamiento del mismo. Para esta seccin se aconseja copiar y pegar las pantallas de dilogo entre el programa y el usuario con el fin de mostrar fidedignamente el funcionamiento de el/los programa(s). Esta seccin rara vez supera en tamao a la de DESARROLLO. Manejando adecuadamente los botones del ratn, bajo el sistema operativo Linux, es posible copiar texto de una terminal para luego insertarlo en un editor y guardarlo como un fichero. En general, se puede elegir el texto a copiar manteniendo presionado el botn izquierdo del ratn; cuando se desea soltarlo (pegarlo) en el editor de texto, simplemente se presionan simultneamente los dos botones del ratn. Esto permitira evitar las capturas de pantalla que suelen consumir demasiados recursos cuando se desea imprimir el informe. 4. CONCLUSIONES, OBSERVACIONES Y/O COMENTARIOS La siguiente seccin que deber aparecer en el reporte es una dedicada a la exposicin de conclusiones, observaciones y/o comentarios sobre el desarrollo de la prctica o los programas elaborados. En esta seccin se pueden exponer, adems de las conclusiones, algunas anomalas, limitaciones o dificultades que el alumno encontr al desarrollar la prctica. Si se desea, se puede incluir en esta seccin algn fragmento de cdigo o algn caso de ejecucin con el fin de ilustrar cierta circunstancia particular del funcionamiento de el/los programa(s). En general, el tamao de un reporte (informe) en papel estar por debajo de las diez pginas siendo su tamao medio de unas cuatro o cinco pginas. 5. BIBLIOGRAFA Esta seccin es opcional y en ella se puede incluir una lista de referencias bibliogrficas que han sido consultadas para realizar la prctica o bien para elaborar el reporte (informa). En el caso de que se quiera listar un libro, un formato recomendado sera el de NOMBRE DEL AUTOR, AO DE PUBLICACIN, TTULO DEL LIBRO, NOMBRE DE LA EDITORIAL. Por ejemplo, Louis E. Frenzel Jr. (1987). A fondo: Sistemas Expertos. Ediciones Anaya Multimedia. Si se desea, por ejemplo, referenciar alguna pgina web el formato recomendado es el de CABECERA DE LA PGINA, DIRECCIN WEB. Por ejemplo, para hacer referencia a mi pgina web se puede escribir lo siguiente: [4] Pgina personal de Hernando Silva http://www.geocities.com/hernandosv/ Como puede notarse, se ha antepuesto un nmero a la referencia. Esta numeracin suele utilizarse cuando dentro del cuerpo del reporte se hace referencia a dicho elemento. Por ejemplo, Los enunciados de las prcticas de Seguridad Informtica y Estructuras de Datos se pueden encontrar en la pgina web del profesor [4] con el fin de que estn disponibles en formato electrnico para todo aqul que quiera ahorrarse el viaje a la fotocopiadora