Difference between revisions of "Redactar"

From Asociación de Robótica UC3M
Jump to navigation Jump to search
Line 22: Line 22:
 
* 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.
 
* 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.
 
* 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".
 
* 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: MTi aparece siempre como MTi, no MTI a veces, etc.
+
* 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.
 
* Sin redundancia, salvo que sea por coherencia interna (que ocurrirá muchas veces).
 
* Sin redundancia, salvo que sea por coherencia interna (que ocurrirá muchas veces).
 
* Evitar extranjerismos sin referenciar (p.e. si el docuemento está en español, como mínimo poner pie de página ante anglicismos).
 
* Evitar extranjerismos sin referenciar (p.e. si el docuemento está en español, como mínimo poner pie de página ante anglicismos).

Revision as of 15:04, 22 September 2015

Algunos consejos básicos, en general de formato, para la redacción de un documento.

Plantilla para LaTeX

Para aquellos que decidan hacer la memoria del TFG (Trabajo de Fin de Grado) en LaTeX, se proporciona a continuación una plantilla completa. (tutorial: LaTeX para TFG en Ubuntu)

Í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).

Texto (Contenido)

  • 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 (en un capítulo de Arquitectura Global o Diseño).

Texto (Formato)

  • Justificado (no alineado a izquierda).
  • Sin faltas de ortografía ni gramática.
  • Sin 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.
  • 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.
  • Sin redundancia, salvo que sea por coherencia interna (que ocurrirá muchas veces).
  • Evitar extranjerismos sin referenciar (p.e. si el docuemento está en español, como mínimo poner pie de página ante anglicismos).

Figuras

  • Centradas.
  • Sin deformar (conservar proporciones originales).
  • Texto explicativo debajo y también centrado.
  • Figuras referenciadas cerca de la propia figura y antes de aparecer, si es posible.
  • Tratar de utilizar y crear imágenes de tipo vectorial para diagramas de flujo, etc. Imágenes de tipo vectorial no pixelan con cambios de zoom. Inkscape (libre, formato SVG o PDF vectorial), Corel (pago, formato propio), y otros muchos programas estilo Dia pueden generar imágenes de tipo vectorial. Powerpoint también puede exportar a PDFs vectoriales. Los PDFs vectoriales se pueden incluir en proyectos que se compilen con pdflatex.
  • Un buscador para imágenes libres: http://search.creativecommons.org/

Tablas

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

Bibliografía

  • 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)".
  • 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. Esto se activa en Google Académico hacia el final de la siguiente página de configuración.

Referencias a Bibliografía

  • 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]).

Fórmulas

  • Referencias entre paréntesis (no corchetes).

Úlitmos consejos

  • ¡Releer el documento entero mínimo una vez!

Específico PFCs UC3M

Más enlaces de interés