Contenido
¿Para qué sirve una memoria técnica?
Una memoria técnica no es “un trabajo para entregar”.
Es un documento que permite que otra persona pueda entender y reproducir exactamente lo que has hecho, sin preguntarte nada.
En el entorno profesional, documentar es tan importante como configurar un servidor.
Una memoria técnica es un documento estructurado que explica de forma clara, objetiva y detallada cómo se ha realizado un trabajo técnico.
- No es un resumen.
- No es una redacción larga.
- No es una opinión.
Es la descripción precisa de un proceso técnico para que otra persona pueda entenderlo, evaluarlo y, si quiere, reproducirlo.
En ingeniería y en informática, la memoria técnica cumple una función muy concreta: convertir lo que has hecho en conocimiento transferible.
Si configuras un servidor y no lo documentas, ese conocimiento vive solo en tu cabeza.
Si lo documentas correctamente, se convierte en algo útil para un equipo, una empresa o incluso para ti mismo dentro de seis meses.
Se usa principalmente para:
– Documentar proyectos técnicos.
– Justificar decisiones técnicas.
– Permitir que otros reproduzcan una instalación o configuración.
– Evaluar trabajos académicos o profesionales.
– Dejar constancia formal de lo realizado.
En el ámbito educativo, sirve además para entrenar una competencia clave: pensar de forma estructurada. Cuando redactas una memoria técnica estás organizando ideas, justificando pasos y demostrando que entiendes lo que haces.
En el mundo profesional, la memoria técnica evita el caos. Imagina una empresa donde nadie documenta nada. Cada vez que algo falla, todo empieza desde cero. Eso no es ingeniería, es improvisación.
Una buena memoria técnica tiene tres características fundamentales:
- Precisión: explica exactamente lo que se ha hecho.
- Claridad: cualquier técnico puede entenderla.
- Reproducibilidad: permite repetir el proceso con el mismo resultado.
En resumen, una memoria técnica transforma acciones en conocimiento estructurado. Y esa capacidad marca la diferencia entre “alguien que sabe hacer cosas” y “un profesional capaz de trabajar en equipo y mantener sistemas complejos”.
Y aquí viene la idea interesante: escribir una memoria técnica no es solo comunicar. Es una forma de comprobar si realmente entiendes lo que has hecho. Porque si no puedes explicarlo con claridad, probablemente todavía no lo dominas del todo.
Documentar es pensar. Y pensar bien es la base de cualquier disciplina técnica.
ESTRUCTURA OBLIGATORIA DE LA MEMORIA
1. Portada
Debe incluir:
- Título del proyecto o práctica
- Módulo
- Nombre del alumno
- Fecha
- Versión del documento (por ejemplo: 1.0)
Ejemplo:
Instalación y configuración de servidor Apache en Ubuntu Server
2. Objetivo del proyecto
En este apartado debes explicar:
- Qué vas a realizar.
- Qué problema estás resolviendo.
- Qué resultado final se espera.
Debe ser claro y técnico.
❌ Incorrecto:
Vamos a instalar Apache.
✅ Correcto:
Implementar y configurar un servidor Apache en Ubuntu Server para alojar un sitio web accesible desde la red local.
3. Descripción del entorno
Aquí debes indicar las condiciones técnicas en las que trabajas.
3.1 Hardware
- Equipo físico o máquina virtual.
- Recursos asignados (RAM, CPU si es relevante).
3.2 Sistema Operativo
- Distribución.
- Versión.
- Arquitectura (si procede).
3.3 Configuración de red
- Dirección IP.
- Tipo de red (NAT, Bridge, etc.).
- Puertos utilizados.
3.4 Software utilizado
- Programas o servicios instalados.
- Versiones si es posible.
Este apartado es obligatorio porque permite reproducir el entorno.
4. Desarrollo del proyecto
Es la parte más importante del documento.
Cada paso debe incluir:
- Qué se va a hacer.
- El comando o acción realizada.
- Una breve explicación técnica.
- El resultado obtenido.
Ejemplo:
4.1 Instalación de Apache
Se instala el servidor web Apache utilizando el gestor de paquetes apt:
sudo apt update
sudo apt install apache2 -y
Tras la instalación, el servicio se inicia automáticamente.
Se comprueba su estado con el siguiente comando:
sudo systemctl status apache2
Resultado: El servicio aparece activo y escuchando en el puerto 80.
⚠ No se deben incluir comandos sin explicación.
⚠ No se deben insertar capturas sin describir lo que muestran.
5. Pruebas realizadas
Aquí debes demostrar que el sistema funciona correctamente.
Ejemplos de pruebas:
- Acceso desde navegador.
- Comprobación de puertos abiertos.
- Pruebas con ping, curl, netstat, ss, etc.
Debes indicar:
- Qué prueba realizas.
- Qué resultado esperas.
- Qué resultado obtienes.
Si no se demuestra el funcionamiento, la práctica no está completa.
6. Problemas encontrados y soluciones
En este apartado debes explicar los errores o dificultades que han surgido.
Formato recomendado:
| Problema | Causa | Solución |
|---|
Ejemplo:
| Error 403 Forbidden | Permisos incorrectos en carpeta web | Se modificaron permisos con chmod |
Este apartado es obligatorio.
Si no has tenido problemas, debes indicarlo explícitamente.
7. Conclusión técnica
Debe ser breve y profesional.
No se admiten opiniones personales.
❌ Incorrecto:
Me ha parecido una práctica interesante.
✅ Correcto:
Se ha configurado correctamente el servidor Apache, verificando su funcionamiento desde un equipo cliente de la red local.
8. Anexos (si procede)
Aquí puedes incluir:
- Archivos completos de configuración.
- Scripts utilizados.
- Diagramas.
- Información adicional relevante.
Normas de redacción obligatorias
- Utilizar lenguaje técnico y objetivo.
- No escribir en primera persona.
- No usar colores innecesarios.
- Numerar correctamente los apartados.
- Las capturas deben estar recortadas y ser legibles.
- El código debe tener formato adecuado.
- No copiar texto sin entenderlo.
Errores frecuentes que debes evitar
- Pegar comandos sin explicación.
- Incluir capturas enormes sin describirlas.
- No indicar el entorno utilizado.
- Escribir conclusiones personales.
- Entregar documentos sin estructura clara.
Importante
Documentar correctamente es una competencia técnica fundamental.
Diferencia entre una Memoria Técnica y un README
En el ámbito técnico es habitual encontrarse con ambos documentos: la memoria técnica y el archivo README. Aunque pueden parecer similares, no cumplen la misma función ni tienen el mismo nivel de profundidad.
Comprender esta diferencia es importante para saber cuándo utilizar cada uno.
¿Qué es un README?
Un README es un archivo introductorio que acompaña a un proyecto, normalmente en un repositorio (por ejemplo, en GitHub).
Su función es explicar de forma clara y rápida:
- Qué es el proyecto
- Para qué sirve
- Cómo instalarlo
- Cómo usarlo
- Qué requisitos necesita
Un README no describe todo el proceso interno del proyecto. No detalla cada paso realizado. Su objetivo es orientar al usuario o desarrollador que quiera utilizar el proyecto.
Es más breve, más práctico y más directo.
Si la memoria técnica explica cómo se construyó el sistema, el README explica cómo usarlo.
Diferencias principales
La diferencia clave está en el nivel de profundidad y en el objetivo.
La memoria técnica documenta el proceso completo.
El README facilita el uso del resultado.
Podemos resumirlo así:
La memoria técnica responde a la pregunta:
¿Cómo se ha desarrollado este proyecto?
El README responde a la pregunta:
¿Cómo puedo utilizar este proyecto?
Ejemplo práctico
Imaginemos que se instala y configura un servidor web Apache.
La memoria técnica incluiría:
- Descripción del entorno
- Instalación paso a paso
- Explicación de cada configuración
- Problemas encontrados
- Pruebas realizadas
- Conclusión técnica
El README incluiría:
- Descripción del servidor
- Requisitos mínimos
- Pasos rápidos para instalarlo
- Comandos necesarios
- Cómo acceder al servicio
La memoria explica el proceso completo.
El README facilita la puesta en marcha.
