Desarrollo web

6 consejos para abordar el código heredado

codigo-heredado

Si has trabajado en el sector digital durante mucho tiempo, en algún momento tendrás que trabajar con código que has heredado de otra persona. Tanto si forma parte de un proceso de traspaso de otra empresa, como si lo ha escrito un desarrollador que se ha marchado o lo ha escrito un freelance, tarde o temprano te encontrarás escudriñando línea tras línea de código que no has escrito tú.

Cuando esto sucede, es fácil caer en una mentalidad negativa. Puede que se utilice una estructura con la que no estás familiarizado, que parezca demasiado complicada, desorganizada o simplemente diferente a tu enfoque de desarrollo habitual: rara vez es un camino de rosas.

“No es mi culpa, ya es un desastre” – dejarse llevar por este tipo de actitud puede crear un monstruo de Frankenstein de un sitio web si no se tiene cuidado. Algo construido con un enfoque ligeramente diferente puede convertirse rápidamente en inmanejable si cada desarrollador que trabaja en el proyecto añade su enfoque subjetivo. Ya sean convenciones de nomenclatura, identificadores de clases o incluso funciones de JavaScript.

A continuación se ofrecen algunos consejos que le ayudarán a preparar y gestionar los sitios web heredados y a verlos como algo que hay que cultivar en lugar de temer.

Pida amablemente la documentación

La documentación de un sitio suele existir en algún lugar de alguna forma. Con suerte. Puede que esté desfasada, pero cualquier cosa es infinitamente mejor que nada. Cuando reciba el código base de un sitio, asegúrese siempre de plantear esta cuestión desde el principio para garantizar que se proporcione toda la documentación durante el proceso de entrega.

Invierta tiempo desde el principio

Tómese el tiempo necesario para entender el código que ha recibido. No se limite a echarle un vistazo. Invierta el tiempo necesario para ver realmente la estructura de archivos, el CMS, los ejecutores de tareas y si el sitio se basa en algún motor de plantillas.

Este sería un buen momento para empezar a documentar el sitio si aún no existe, o añadir tus propias notas a cualquier documentación existente.

No podrás llevar a cabo con éxito las actualizaciones de un sitio que no entiendes. El resultado será un código ofuscado y plagado de errores que no hará más que alargar el tiempo necesario para llevar a cabo incluso las tareas más pequeñas.

Asegúrese de conocer el mapa del sitio, cuántas páginas hay y dónde está el código de esas páginas dentro de la estructura. Esto le ayudará a identificar cualquier código obsoleto o no utilizado que pueda ser eliminado. Compruebe también si hay bibliotecas de JavaScript sin usar. Los sitios antiguos, o los que han tenido varios desarrolladores o agencias trabajando en ellos, a menudo pueden llevar mucho exceso de equipaje. Todo lo que pueda ordenar o eliminar beneficiará innegablemente a la longevidad del sitio.

Abordar la funcionalidad desconocida

No espere a que se rompa. Echa un vistazo a cualquier funcionalidad que dé miedo en el sitio y asegúrate de que eres plenamente consciente de todas y cada una de las complejas integraciones de la API. Asegúrate de que se entienden y se documentan claramente.

Cuando trabajes con esta funcionalidad, añade o actualiza los comentarios en el código para dejar claro qué funciones están haciendo qué y por qué; ahorrándote a ti mismo y a los demás tener que averiguarlo cada vez que se retome el proyecto.

Mantén la coherencia

Aprende el sistema y ajusta tus hábitos de escritura de código para que se adapten al estilo actual. Familiarícese con las clases y funciones reutilizables para no duplicar ningún código. Esto ayudará a reducir la hinchazón general, aumentar la longevidad y mejorar la legibilidad si el sitio se pasa a otro equipo de desarrollo.

Agregar sus propios métodos de codificación a un sitio heredado hará que sea mucho más difícil para otros desarrolladores; por lo tanto, aunque adaptar su enfoque puede parecer contraintuitivo, la voluntad de ser flexible es realmente beneficiosa aquí.

Dedicar algo de tiempo a la analítica

Es importante familiarizarse con la mayor parte del sitio web posible, y hurgar en las analíticas puede darte mucha información útil. Conozca los dispositivos en los que los usuarios ven el sitio y los navegadores que requieren soporte. Al tener este conocimiento desde el principio, estarás preparado para cuando llegue un nuevo trabajo y sabrás qué fallos hay que poner en marcha y podrás estar preparado para las pruebas.

Realice siempre una prueba de velocidad del sitio para detectar cualquier problema importante de rendimiento. Es posible que haya algunas ventajas rápidas que puedas implementar para mejorar el sitio, como optimizar las imágenes grandes o minificar los archivos CSS o JavaScript.

No utilice la excusa de “alguien más lo construyó”

Tenemos que dejar el hábito de escribir código malo y perezoso porque “ya es un desastre”. Crear un proyecto de pesadilla no es algo que tu equipo en general quiera tocar. Todos hemos escrito código del que no estamos especialmente orgullosos en algún momento, a menudo por razones ajenas a nuestro control.

Los plazos de entrega ajustados, el aumento del alcance y los clientes difíciles son sólo algunos de los factores que pueden afectar a la calidad de la creación de un sitio web. Deja de buscar culpables y céntrate en las formas de mejorar lo que tienes. Enorgullézcase siempre de su trabajo.

El tiempo y el esfuerzo que dedicas a cualquier sitio, tanto si lo construyes desde cero como si lo heredas, da sus frutos a largo plazo, ya que crea un proyecto legible y mantenible. Usted, el equipo que le rodea y el cliente se beneficiarán enormemente de tener una actitud positiva hacia los sitios heredados.

Así que la próxima vez que te encuentres con que tienes que recoger el código de otra persona (antes de que pongas los ojos en blanco y empieces a murmurar obscenidades para ti mismo) repasa estos consejos y puede que conviertas un proyecto potencialmente de pesadilla en una brisa.

Deja una respuesta