From: Adolfo Di Mare To: Pipino Cuevas Date: Mon, 26 Jul 2010 16:33:52 -0600 Subject: Recetario para hacer la tesis X-PMFLAGS: 34078720 0 1 cls.cnm [[[ Como ejemplo uso “Convertir BUnit para que funcione con Javadoc” ]]] Para redactar la tesis ====================== (-) Defina el tema (-) Obtenga [N] artículos sobre el tema de la tesis (-) Escriba la introducción de la tesis (-) Defina las ideas que le permitirán hacer la tesis (-) Escriba el índice de la tesis (-) Escriba las conclusiones de la tesis (-) Rellene la propuesta (-) Desarrolle la tesis (-) Escriba un artículo sobre la tesis (-) Defienda la tesis Para redactar la propuesta de tesis =================================== (-) Defina el tema (-) Obtenga [N/4] artículos sobre el tema de la tesis (-) Escriba la introducción de la tesis (-) Escriba el índice de la tesis (-) Escriba las conclusiones de la tesis (-) Rellene la propuesta Consejos sobre redacción ======================== (-) Use Google/Voice para dictar el documento (-) Agregue comas y puntos (-) Páguele a un filólogo /*===========*\ || REDACCION || \*===========*/ Cuando la propuesta o la tesis tienen errores de redacción es muy difícil que los profesores y evaluadores la acepten. Por eso, es necesario eliminarle los errores de redacción lo mejor posible. Este recetario busca ayudar en ese proceso, al tenor de las nuevas herramientas que están disponibles ahora. 1) Use Google/Voice para dictar el documento ============================================ Quienes tienen 10 o más años de escribir encuentran que les es más sencillo teclear sus ideas directamente en el editor de texto, pues ya saben cómo lograr que el “hilo de pensamiento” pese a que la velocidad de los dedos es demasiado lenta en comparación a la del pensamiento o la de la voz hablada. Para quienes tienen poca experiencia como escritores, digitar palabras en la computadora es una tarea incómoda, porque no pueden mantener en su mente las ideas debido la lentitud con que pueden digitarlas. Sin embargo, estas personas puede usar herramientas de transcripción de vos, como las que provee Google, para dictarle a la computadora lo que piensan. El dictado puede hacerse utilizando un micrófono conectado al computador, pero en muchas ocasiones es más sencillo usar un teléfono inteligente en el que se ha seleccionado la opción “micrófono” como teclado de entrada. Debido a que el reconocimiento de vos necesita de un poder de cómputo enorme, lo usual es que el traductor de vos no sea un programa instalado en el computador sino que se use la enorme potencia de cómputo que Google tiene disponible. Por eso, no puede hacerse la transcripción sin una conexión Internet de mediana velocidad, pues cada frase debe ser enviada a través de la red para que el mega-transcriptor de Google la pase a texto. “El traductor de google es muy preciso y no puede incorporar omar puntos y por eso debe ser realizado después de amarlo”. Esta frase no quedó bien transcrita, pues la versión correcta es esta: “El traductor de Google NO es muy preciso y no puede incorporar COMAS O puntos y, por eso, lo que produce debe ser REVISADO después de dictarlo”. Otro ejemplo: “Se retira entiende” en lugar de “SI HABLO MUY RÁPIDO LA MÁQUINA NO entiende”. Al dictar es necesario pronunciar correctamente todas las palabras, con un poco de lentitud, y en un sitio en donde no haya ruido en el ambiente. La velocidad de dicción adecuada es la que se usa al comunicarse con un extranjero que no entiende a menos que se le hable despacio pues, al hablar coloquialmente, el extranjero no es capaz de distinguir las palabras y lo que oye es bulla. Aquí hay más detalles sobre el motor de transcripción de vos de Google: - http://ddg.gg/?q=google+voice+transcription - http://google.com/search?num=100&q=google+voice+transcription 2) Agregue comas y puntos ========================= “El texto dictado a google no puede contener puntos y comas egipto un truco que se puede usar para agregar estas marcas escritas egipto que es usar una palabra que marque el sitio en donde hay que poner cada signo de puntuación egipto por ejemplo en este caso egipto estoy usando egipto la palabra egipto como marcador de puntuación”. En este párrafo la palabra “egipto” sirve para marcar los sitios en que hay que poner algún signo de puntuación. Si se usa un editor de texto que permita expresiones regulares (como es el caso de http://Notepad-plus-plus.org y de http://EditPlus.com ), se puede sustituir “egipto” por la expresión regular “.,\r\n” para obtener algo similar a lo siguiente: El texto dictado a google no puede contener puntos y comas ., un truco que se puede usar para agregar estas marcas escritas ., que es usar una palabra que marque el sitio en donde hay que poner cada signo de puntuación ., por ejemplo en este caso ., he usado., la palabra ., como marcador de puntuación Este texto puede ser levemente editado para obtener el texto con puntos y comas: COMO EL texto dictado a GOOGLE no puede contener puntos y comas, un truco que se puede usar para agregar estas marcas escritas ES usar una palabra que marque el sitio en donde hay que poner cada signo de puntuación. POR ejemplo, en este caso, he usado LA palabra “egipto” como marcador de puntuación. Colocar comas es un poco más difícil que colocar puntos, pues un punto cierra una frase mientras que una coma sirve para darle un respiro al lector. Por eso, puede ser una mejor estrategia, solo colocar puntos en los sitios en que aparece la palabra marcadora de puntuación “egipto”, en cuyo caso hay que sustituir “ egipto” (con un espacio) por la expresión regular a utilizar es “.\r\n” (sin la coma): El texto dictado a google no puede contener puntos y comas. un truco que se puede usar para agregar estas marcas escritas. que es usar una palabra que marque el sitio en donde hay que poner cada signo de puntuación. por ejemplo en este caso. estoy usando. la palabra. como marcador de puntuación Una vez que las frases separadas por puntos han sido identificadas, lo que sigue es agruparlas en párrafos. Para colocar los otros signos de puntuación se pueden usar muchos trucos, como los descritos aquí. - http://ddg.gg/?q=colocar+signos+puntuacion - http://google.com/search?num=100&q=colocar+signos+puntuacion 3) Páguele a un filólogo ======================== Uno de los errores más frecuentes que comete el escritor novato es omitir palabras que son necesarias para que la frase esté completa y exprese la idea del escritor. Una forma sencilla de lograr detectar estos vacíos es pedirle a otra persona que lea el documento escrito. Sin embargo, si no hay alguien disponible en ese momento, un efecto similar se puede obtener leyendo el documento un par de días después de escrito, cuando ya las ideas no están frescas, por lo que es más sencillo detectar estos vacíos. Los procesadores de palabras incluyen diccionarios que permiten afinar la ortografía del documento y, por eso, es necesario usarlos para corregir gazapos. En caso de duda, siempre es saludable consultar el “Diccionario de la lengua española” disponible en la red en el sitio http://rae.es (Real Academia Española). De todas formas, después de que el documento parece bien escrito, es necesario que un filólogo lo revise. Eso puede parece caro, pero en realidad no lo es, pues si el documento tiene errores de redacción es posible que los profesores que lo evalúen no lo lean, porque no lo entienden, o lo rechacen sin ojearlo, pues casi todos los profesores consideran que es una falta de respeto que les entreguen documentos que están mal escritos. /*=======*\ || TESIS || \*=======*/ 1) Defina el tema ================= Después de conversar con el profesor guía y definir quiénes son los integrantes del comité asesor de tesis, el estudiante debe definir con exactitud el tema de su tesis, lo que incluye definir el nombre y los objetivos, tanto el general como los específicos. Nombre de la tesis: Uso de pruebas xUnit para mejorar las especificaciones Java/C# Objetivo: Mejorar la calidad de las especificaciones de los módulos Java/C# aumentándolas con pruebas unitarias xUnit. Objetivos específicos: 1) Incorporar en Java/C# la funcionalidad necesaria para generar especificaciones que incluyan casos de uso adecuados, principalmente usando ejemplos assertTrue(). 2) Mostrar que los programadores pueden incluir especificaciones adecuadas para sus módulos si reutilizan las pruebas unitarias como ejemplos de uso. 3) Mejorar la capacidad de los programadores de manera que puedan crear especificaciones más completas usando sus habilidades de programación. 4) Proponer un plan de acción y de educación que permita incorporar los logros de esta tesis en el quehacer diario de empresas o instituciones dedicadas a la construcción de programas en la plataforma Java. 5) Cuantificar las ideas teóricas desarrolladas en este trabajo de investigación. 2) Obtenga N artículos sobre el tema de la tesis ================================================== -[200] -> Para Licenciatura -[300] -> Para Maestría -[500] -> Para Doctorado Es importante conocer lo que otros han hecho cuando uno investiga y por eso es necesario hacer una búsqueda bibliográfica extensa y profunda. Usando el acceso Internet desde cualquier computador dentro de la UCR es posible acceder a la mayor parte de los artículos de investigación publicados en los últimos 20 años. Es necesario recolectar todas esas referencias bibliográficas, incluyendo el URL de adonde están almacenadas, y luego anotar cada artículo con las observaciones relevantes después de leerlo. Para determinar cómo evalúa la academia cada tesis es saludable examinar lo que los graduados del plan de doctorado han hecho. Es mejor darle más importancia a los trabajos que recibieron alguna distinción. Los 2 repositorios más importantes de artículos en computación son éstos: - http://ACM.org - http://IEEE.org Además, otro sitio en donde se puede obtener mucha bibliografía es el siguiente: - http://citeseerx.ist.psu.edu/ Lo usual es guardar cada artículo en formato .PDF, incluyendo el nombre del artículo y el del autor: - Recomendaciones para la preparación de propuestas de tesis - DiMare 1997.pdf - Recomendaciones para la preparación de propuestas de tesis - DiMare 1997.url Formato: - Titulo del articulo - apellido, apellido 2009.pdf - Testing Embedded Software - Broekman, Notenboom 2003.pdf - Unit Test Frameworks - Hamill 2004.chm - The C++ Programming Language Special 3ed - Stroustrup 1997.pdf Es importante guardar también la dirección electrónica de la descarga: - Software Engineering - Boehm 1976.pdf - Software Engineering - Boehm 1976.url - http://www.cs.virginia.edu/papers/p319-boehm.pdf +----------------------------------------------------+ |[InternetShortcut] | |URL=http://www.cs.virginia.edu/papers/p319-boehm.pdf| +----------------------------------------------------+ En la tesis es importante referenciar por lo menos la tercera parte de los artículos recabados. Funciona bien meter todas las referencias en una base de datos BibTex que puede luego ser utilizada desde http://LyX.org y LaTex2e con \cite{} pues eso facilita mucho ponerlas luego en el aparte correspondiente de la propuesta y de la tesis. - http://en.wikipedia.org/wiki/BibTeX 3) Escriba la introducción de la tesis ====================================== Esta parte siempre es la que se muestra en la propuesta de tesis, por lo que escribirla desde el principio ayuda a definir el tema de estudio para evitar hacer trabajo que a fin de cuentas no era importante o relevante para construir la tesis. 4) Defina las ideas que le permitirán hacer la tesis ==================================================== El truco para que hacer la implementación es usar los “taglets” de Javadoc: - http://docs.oracle.com/javase/1.5.0/docs/tooldocs/windows/javadoc.html#taglet 5) Escriba el índice de la tesis ================================ Este índice tentativo sirve para definir el cronograma de actividades pues la duración de la construcción de una tesis no debiera tomar más de 4 meses. Contenido de la tesis Cap.1: Marco Teórico Cap.2: Especificaciones xUnit Cap.3: Tecnología Javadoc Cap.4: Tecnología Microsoft Cap.5: Evaluación estadística de especificaciones xUnit Cap.6: Sugerencias sobre el curso Programación I Cap.7: Conclusiones Anexos: - Código fuente especificaciones - Código fuente Javadoc modificado - Taller con estudiante / programadores - Video-tutor para estudiantes - Programa reformado del curso Programación 1 6) Escriba las conclusiones de la tesis ======================================= “Quien no sabe adónde va, ¡llega a otro lado!” Para acertar en el blanco es necesario apuntar primero. Aunque al finalizar el trabajo es posible que las conclusiones sean diferentes a las enunciadas aquí, el haberlas definido de antemano sirve para lograr enfocar y definir el trabajo a realizar. 7) Rellene la propuesta ======================= El contenido de una propuesta de tesis ya está bien definido, por ejemplo en: - http://www.di-mare.com/adolfo/p/pretesis.htm Basta tomar el temario y rellenarlo, agregándole las referencias bibliográficas correspondientes. Por lo general, en la propuesta es necesario poner referencias al 20% de los artículos que previamente fueron recopilados. Toda propuesta debe estar escrita en buen español, sin faltas de ortografía o de redacción. El estudiante que carezca de las destrezas necesarias para redactar deberá obtener ayuda profesional porque el comité de tesis nunca hace ese trabajo. Las tesis y propuestas mal escritas son rechazadas de plano. 8) Desarrolle la tesis ====================== Si ya uno sabe qué tiene que hacer.. ¡simplemente lo hace! ¡¡¡ Brete, brete !!! 9) Escriba un artículo sobre la tesis ===================================== Toda tesis incluye una contribución original o especial. Es saludable tomar lo más relevante y encapsularlo en el formato de un artículo académico, con el fin de difundir los resultados obtenidos. Este artículo debe incluir como coautor al tutor, que es quien define la dirección e intensidad de la investigación. 10) Defienda la tesis ===================== La defensa tiene 2 partes importantes. La primera consiste en convencer al comité asesor de que el trabajo está bien encaminado. En el comité hay 2 equipos: uno formado por el estudiante y su tutor, y el otro formado por los demás profesores. No es saludable que el estudiante negocie solo con los otros profesores, porque el resultado es una desviación del plan original de trabajo. Por eso, cuando se hagan reuniones con el comité asesor, es mejor que también acuda el tutor. Cuando ya la tesis está lista, el estudiante debe hacer una defensa completa ante el comité. Debe presentarse a tiempo y debe estar bien preparado. Debe tener una actitud tranquila. Durante esta presentación preliminar debe evitarse interrupciones por parte del comité asesor. Todo material que se entrega al comité asesor debe haber sido revisado y aprobado previamente por el tutor. 11) ¿Quién trabaja? =================== Finalmente quiero recordarte que no seré yo quien te empuje a hacer todo este trabajo. Si no veo que hayás avanzado este mismo semestre, seguramente no me va a interesar continuar apoyándote. Como decimos los del vulgo: “Viendo el payaso... ¡soltando la risa!” Adolfo ///