Redactar

Para redactar, existen dos herramientas populares: Microsoft Word, y LaTeX. Microsoft Word es más visual, y LaTeX se parece más a programar. Una ventaja de LaTeX es que es Open Source, por tanto, si falla algo, puede ser difícil, pero tienes la posibilidad de arreglarlo.

Nota para UC3M: Existe mucha documentación en Campus Global, y en UC3M/Biblioteca (incluida Matriz de Criterios de Evaluación de PFCs de la UC3M, y hoja Excel para presupuestos (?)). Mirar también Nuestros recursos digitales.

Plantillas

• Grado LaTeX (UC3M). Tutorial para éste: Ubuntu TFG LaTeX (UC3M).

• Master LaTeX (UC3M). Portada Master (UC3M).

Índice

• Una profundidad de índice admisible es hasta 3 subniveles (sección 2.3.4), aunque luego en el documento se desglosen más (sección 2.3.4.c).
• Cantidad de páginas por capítulo compensado (no tiene sentido que un capítulo sea de 80 páginas y otro de 3).
• Aquí un ejemplo de índice:

1. Introducción (con introducción, objetivos, estructura del documento)
2. Estado del arte A+B+C
3. Arquitectura global (aquí entra bien un diagrama de flujo general)
4. Desarrollo A
5. Desarrollo B
6. Desarrollo C
7. Experimentos y resultados
8. Conclusiones y líneas futuras (con conclusiones y líneas futuras)

• • Bibliografía
  • Anexos (sí: presupuesto)(posible: partes relevantes de datasheets)(no códigos fuentes completos, mejor proporcionar diagramas de clases, etc., y citar URL del código fuente en documento).

Estado del arte

• El estado del arte de un documento científico debería consistir en referencias a documentos científicos que componen la Bibliografía, tanto por que sean útiles o porque posteriormente se debata que se hayan superado. También debería servir para explicar alternativas software o hardware, como apoyo para justificar decisiones de diseño que se tomen más adelante en el documento.

Bibliografía

• Existen muchos gestores de bibliografía: Mendeley (que dispone de plugins recomendables para Microsoft Word y LibreOffice), Zotero... En LaTeX, se puede utilizar uno de estos gestores, o trabajar directamente sobre el archivo .bib (no se recomienda trabajar sobre el .bbl sino generarlo con bibtex a partir del .bib).
• Es necesario que todos los elementos de la bibliografía estén referenciados.
• El orden de los elementos debe ser el de aparición en el documento (ciertos autores prefieren orden alfabético).
• Tratar de evitar bibliografía del que solo se disponga una URL (foros, webs...). En caso de ser realmente necesario, es obligatorio poner la fecha de acceso: "(último acceso 22 de febrero de 2011)", y en general es casi preferible que sea simplemente un pie de página.
• En lugar de foros o webs, tratar de utilizar bibliografía científica: preferiblemente "Journals", o "Proceedings of Conferences" si no.
• Para localizar bibliografía científica, utiliza buscadores como Google Académico o IEEExplore que dispongan de la opción de importar citas a bibtex o semejante.

Formato (Importante)

• Respecto a títulos de documento/capítulo/secciones: "Esto es un título en español". "This Is A Title In English". Ninguno acaba en punto.
• Como norma general, ceñirse a las plantillas, sin modificar márgenes ni introducir excesivos modificadores de formato. La inclusión de ciertos paquetes de LaTeX también pueden crear conflictos.
• Texto justificado (no alineado a izquierda).
• Evitar faltas de ortografía/gramática.
• Evitar faltas en la puntuación: espacio después de punto, etc. Cuidado en mayúsculas/minúsculas.
• Evitar la reutilización de frases completas de otros documentos (copia+pega). Incluso las licencias más abiertas piden que se cite la fuente original.
• Utilizar frases cortas. Como regla general, se puede pensar "no más de un concepto por frase, tal vez más de una frase para explicar un solo concepto".
• Coherencia interna. Ejemplo 1: MTi debe aparecer siempre como MTi, no MTI a veces. Ejemplo 2: Un algoritmo es siempre un algoritmo, no pasa a ser un método o infraestructura en un mismo documento.
• Evitar extranjerismos sin referenciar (p.e. si el documento está en español, como mínimo poner pie de página ante anglicismos).
• Respecto a citas bibliográficas:
  • La regla general es citar la referencia sólo la primera vez que aparece. Excepciones: no se introduce en el resumen/abstract (sí en la introducción); se puede volver a citar cuando ha pasado un cierto número de páginas (p.ej. capítulos diferentes).
  • Se deja un espacio entre la palabra y la referencia, como se hace en esta frase [1]. Es recomendable, además, que esta frase pueda leerse habiendo omitido la referencia (p.antiejemplo: léase [3] y [16]).
• Respecto a ecuaciones:
  • Referencias entre paréntesis (no corchetes).

Figuras

• Centradas.
• Sin deformar (conservar proporciones originales).
• Texto explicativo debajo y también centrado.
• Figuras siempre referenciadas. Si es posible, cerca de la propia figura, y antes de aparecer.
• Figuras vectoriales. Siempre que se pueda (logotipos, diagramas de flujo, etc) crear y utilizar imágenes de tipo vectorial. Estas imágenes no se pixelan con cambios de zoom. Se recomienda Inkscape como la alternativa libre referencia (existen alternativas propietarias como Adobe Illustrator o Corel). Para generar diagramas, tanto yEd (freeware) como Dia (libre) son buneas opciones. Powerpoint también puede exportar a formatos vectoriales. El formato vectorial editable más recomendable es el .svg de Inkscape, o los propios de cada programa. Para incrustar en documentos LaTeX (pdflatex), se recomienda exportar a PDF. Para incrustar en documentos Word, se recomienda exportar a EMF (o WMF si sale mal). Aquí un enlace con logos en vectorial: https://svn.code.sf.net/p/asrob/svn/admin/Logos/
• Un buscador para imágenes libres: http://search.creativecommons.org/
• Diagramas de clases UML si hay SW.

Tablas

• Centradas.
• Texto explicativo normalmente encima y también centrado.

Úlitmos consejos

• Se empezó a realizar un script que revisa textos en inglés aquí (permalink).
• ¡Releer el documento entero mínimo una vez!

Más enlaces de interés

• Consejos generales para la presentación de un documento.
• File:Formatobasicopararedactareportes.pdf