Un proyecto web no se desordena solo por tener muchos archivos. Se vuelve difícil de mantener cuando cada persona aplica una lógica distinta: una diseñadora guarda cabecera-final, un desarrollador crea header-new y quien valida el trabajo descarga version_buena_2. Durante unos días todos recuerdan qué significa cada nombre. Al cabo de un mes, el contexto desaparece y abrir archivos uno por uno parece la única forma de saber cuál corresponde.
Una convención útil no pretende describir cada detalle ni sustituir al control de versiones. Su objetivo es conservar las pistas mínimas para identificar el contenido, su función y, cuando sea relevante, su estado. Debe poder aplicarse sin consultar un manual a cada paso. Si nombrar un recurso requiere demasiadas decisiones, el equipo acabará saltándose la norma.
Empieza por las preguntas de búsqueda
Antes de fijar guiones, fechas o abreviaturas, conviene pensar cómo se recuperará el archivo. En un proyecto web solemos buscar por página, componente, campaña, idioma o tipo de entrega. Esas son las piezas que deberían aparecer en el nombre. El programa con el que se creó el documento suele importar menos, porque la extensión ya aporta esa información.
Para una imagen de una ficha de producto, por ejemplo, una secuencia como producto-vista-formato suele ser más útil que el nombre automático de la cámara. En documentación interna puede funcionar proyecto-asunto-fecha. No existe un patrón universal, pero sí un principio estable: colocar primero el dato por el que el equipo agrupa y busca con mayor frecuencia.
Reglas pequeñas que evitan problemas grandes
- Usa palabras comprensibles y abreviaturas acordadas, no códigos personales.
- Elige un separador y mantenlo. Los guiones simples suelen leerse bien en distintos sistemas.
- Evita términos como nuevo, bueno o definitivo, porque envejecen en cuanto aparece otra revisión.
- Incluye una fecha en formato año-mes-día solo cuando la cronología ayude a distinguir entregas.
- No repitas en el nombre toda la ruta de carpetas: añade únicamente el contexto que sobreviviría si el archivo se moviera.
También merece la pena decidir cómo se escriben idiomas, tamaños y variantes. Si unas veces aparece es y otras spanish, la búsqueda deja de agrupar lo relacionado. Una lista corta de códigos permitidos evita esa fragmentación. Lo mismo sucede con dimensiones como desktop, tablet y mobile.
Separa archivo, versión y estado
El nombre no debe cargar con todo el historial de cambios. El repositorio de código, el gestor documental o la herramienta de diseño pueden conservar versiones. Cuando esos sistemas no existen, una numeración simple y ascendente resulta más fiable que una cadena de adjetivos: v01, v02 y v03. Conviene reservar aprobado para una decisión real y documentada, no para expresar optimismo.
En entregas a clientes puede ser útil separar el archivo editable del exportado. La base del nombre se mantiene y cambia la extensión o un sufijo controlado. Así se reconoce que ambos pertenecen a la misma pieza y se reduce el riesgo de enviar una revisión anterior. Si el cliente impone su propia referencia, se conserva ese número junto al nombre comprensible.
Para profundizar en un criterio que siga teniendo sentido cuando el contexto se ha olvidado, resulta útil revisar cómo nombrar archivos para encontrarlos meses después. La idea encaja especialmente bien en proyectos que pasan de una persona a otra o vuelven a abrirse tras un periodo de pausa.
Carpetas y repositorios también forman parte del sistema
Una buena convención fracasa si vive dentro de una jerarquía incoherente. La estructura debería separar, como mínimo, material de entrada, trabajo en curso y entregables. En desarrollo web, el código fuente tiene además sus propias reglas y no conviene mezclarlo con actas, facturas, capturas o exportaciones pesadas. Cada tipo de contenido necesita un lugar de referencia claro.
Los archivos generados automáticamente merecen una consideración especial. Si pueden reconstruirse desde el código, quizá no deban guardarse junto a los originales. Documentar esta decisión reduce duplicados y evita que alguien edite por error una salida que será sobrescrita en la siguiente compilación. La convención de nombres debe acompañar al flujo técnico, no competir con él.
Cómo implantar la convención sin paralizar el trabajo
- Elige un proyecto activo y detecta cinco tipos de archivo que generan dudas reales.
- Propón un patrón breve con ejemplos correctos e incorrectos.
- Pruébalo durante dos semanas y anota las excepciones frecuentes.
- Ajusta solo lo necesario y guarda la regla en un lugar visible del proyecto.
- Aplica la convención a lo nuevo; migra el histórico únicamente cuando vaya a reutilizarse.
No hace falta renombrar años de material para obtener beneficios. Empezar hoy crea una frontera clara: lo nuevo entra ordenado y lo antiguo se corrige cuando vuelve a ser relevante. En archivos compartidos, los cambios masivos deben coordinarse porque pueden romper enlaces, referencias o automatizaciones. Una migración progresiva es más segura que una limpieza impulsiva.
La prueba definitiva: que otra persona lo entienda
La convención funciona cuando alguien ajeno a la decisión puede localizar una entrega, distinguir el original de una exportación y reconocer qué versión está vigente sin preguntar. Una revisión trimestral basta para comprobar si han aparecido abreviaturas nuevas, duplicidades o estados ambiguos. El sistema no necesita ser perfecto; necesita seguir siendo comprensible.
Los mejores nombres parecen poco creativos porque repiten una estructura predecible. Esa monotonía es una ventaja: reduce preguntas, facilita búsquedas y permite automatizar tareas. Un archivo bien nombrado conserva contexto, mientras que una norma breve compartida convierte cientos de decisiones individuales en un lenguaje común para todo el proyecto web.
