Cuando haya trabajado en la industria digital durante el tiempo suficiente, eventualmente tendrá que trabajar con un código que ha heredado de otra persona. Ya sea que esto sea parte de un proceso de entrega de otra empresa, escrito por un desarrollador que ya se ha mudado o escrito por un profesional independiente, tarde o temprano te encontrarás revisando línea tras línea de código que no escribiste.
Cuando esto sucede, es fácil caer en una mentalidad negativa. Puede estar utilizando una estructura con la que no está familiarizado, parecer demasiado complicada, desorganizada o simplemente diferente a su enfoque de desarrollo normal; rara vez es sencillo.
Algo construido con un enfoque ligeramente diferente puede volverse rápidamente inmanejable
“No es mi culpa, ya es un desastre”: dejarse llevar por este tipo de actitud puede crear un sitio web monstruoso de Frankenstein si no tiene cuidado. Algo creado con un enfoque ligeramente diferente puede volverse rápidamente inmanejable si cada desarrollador que trabaja en el proyecto agrega su enfoque subjetivo. Ya se trate de convenciones de nomenclatura, identificadores de clase o incluso funciones de JavaScript.
A continuación se incluyen algunos consejos para ayudarlo a prepararse y administrar sitios web heredados y verlos como algo para nutrir en lugar de temer.
1. Pida amablemente la documentación
La documentación para un sitio a menudo existirá en algún lugar en alguna forma. ¡Ojalá! Puede estar desactualizado, pero cualquier cosa es infinitamente mejor que nada. Al recibir el código base de un sitio, asegúrese siempre de que esta pregunta se plantee con anticipación para garantizar que se proporcione toda la documentación durante el proceso de entrega.
2. Invierta el tiempo temprano
Tómese el tiempo para comprender el código que ha recibido. No te limites a echarle un vistazo. Invierta el tiempo para observar realmente la estructura de archivos, el CMS, los ejecutores de tareas y si el sitio depende o no de algún motor de plantillas.
Los sitios más antiguos… a menudo pueden llevar mucho exceso de equipaje
Este sería un buen momento para iniciar alguna documentación para el sitio si aún no existe, o agregar sus propias notas a cualquier documentación existente.
No podrá realizar con éxito actualizaciones en un sitio que no entienda. El resultado será un código ofuscado y lleno de errores que solo prolongará 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 se encuentra el código de esas páginas dentro de la estructura. Esto lo ayudará a identificar cualquier código obsoleto o sin usar que pueda eliminarse. Compruebe también las bibliotecas de JavaScript no utilizadas. Los sitios más antiguos, o sitios que han tenido varios desarrolladores o agencias trabajando en ellos, a menudo pueden tener mucho exceso de equipaje. Cualquier cosa que pueda ordenar o limpiar sin duda beneficiará la longevidad del sitio.
3. Abordar la funcionalidad desconocida
¡No esperes a que se rompa! Eche un vistazo a cualquier funcionalidad aterradora en el sitio y asegúrese de estar completamente al tanto de todas y cada una de las integraciones de API complejas. Asegúrese de que estos se entiendan y documenten claramente.
Cuando trabaje con esta funcionalidad, agregue o actualice comentarios en el código para aclarar qué funciones están haciendo qué y por qué; ahorrándose a sí mismo y a los demás tener que resolverlo cada vez que se retome el proyecto.
4. Mantenlo consistente
Aprenda el sistema y ajuste sus hábitos de escritura de código para adaptarse 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 transfiere 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 de entender para otros desarrolladores; por lo tanto, aunque adaptar su enfoque puede parecer contrario a la intuición, la voluntad de ser flexible es realmente beneficiosa aquí.
5. Pase algún tiempo en el análisis
Es importante familiarizarse con la mayor cantidad posible del sitio, y profundizar en los análisis puede brindarle mucha información útil. Conozca en qué dispositivos los usuarios están viendo el sitio y qué navegadores requieren soporte. Tener este conocimiento desde el principio significa que está preparado cuando llega un nuevo trabajo y sabe qué alternativas implementar y puede estar preparado para la prueba.
Siempre ejecute el sitio a través de una prueba de velocidad del sitio para marcar cualquier problema importante de rendimiento. Puede haber algunas ganancias rápidas que puede implementar para mejorar el sitio, como optimizar imágenes grandes o minimizar archivos CSS o JavaScript.
6. No utilices la excusa de que “alguien más lo construyó”
Tenemos que quitarnos el hábito de escribir código malo y perezoso porque ‘ya es un desastre’. Crear un proyecto de pesadilla no es algo que su equipo en general quiera tocar. Todos hemos escrito código del que no estábamos particularmente orgullosos en algún momento, a menudo por razones fuera de nuestro control.
Todos hemos escrito código del que no estábamos particularmente orgullosos…
Los plazos ajustados, el avance del alcance y los clientes difíciles son solo algunos de los factores que pueden afectar la calidad de la construcción de un sitio. Aléjese de buscar a alguien a quien culpar y concéntrese en las formas en que puede mejorar lo que tiene. Siéntete siempre orgulloso de tu trabajo.
El tiempo y el esfuerzo que inviertes en cualquier sitio, ya sea que lo construyas desde cero o lo heredes, vale la pena a largo plazo, ya que crea un proyecto legible y fácil de mantener. Usted, el equipo que lo rodea y el cliente se beneficiarán enormemente de tener una actitud positiva hacia los sitios heredados.
Entonces, la próxima vez que tenga que elegir el código de otra persona (antes de poner los ojos en blanco y comenzar a murmurar obscenidades para sí mismo), siga estos consejos y puede convertir un posible proyecto de pesadilla en una brisa.
Foto principal a través de Unsplash.