Redactar

From Asociación de Robótica UC3M
Revision as of 10:23, 21 May 2018 by Jgvictores (talk | contribs)
Jump to navigation Jump to search

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

Í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