Volver al blog
📖 Tutoriales de herramientas 管理员 · · 4 minutos · 15 Vistas

Después de los despidos en las grandes tecnológicas, acepté trabajos freelance y descubrí que lo que más le importa al cliente es el formato del código

Después de que me despidieran de una gran tecnológica, acepté trabajos freelance. Pensaba que con tener buena técnica bastaba, pero el primer cliente se quejó de que el código era un desastre y no se entendía. Resulta que a los ojos del cliente, el código comprimido y ofuscado es como un libro sellado, mientras que un código bien formateado representa profesionalismo y fiabilidad. Este artículo comparte esa experiencia y habla de por qué la legibilidad del código es más importante que presumir de técnica, y cómo una pequeña herramienta de formateo me ayudó a ganarme la confianza de los clientes.

Con la ola de despidos de finales del año pasado, varios de mis amigos no se salvaron. Yo tampoco. Cobré la indemnización y me fui a casa. Las dos primeras semanas estuvieron bien: dormir hasta que el cuerpo aguante, jugar videojuegos, ver series. Pero al llegar la tercera semana, al ver que el saldo del banco solo bajaba y no subía, empecé a inquietarme. La hipoteca y el coche no entienden de desempleo; llega el día y hay que pagar.

Sin remedio, empecé a buscar trabajos en grupos de encargos. Antes, escribiendo código en la empresa, pensaba que con tener buena técnica bastaba: arquitectura, algoritmos, optimización de rendimiento, lo decía sin pensar. Pero al aceptar mi primer trabajo freelance, la realidad me dio una bofetada brutal.

El cliente era un pequeño empresario de comercio electrónico, me encontró por recomendación de un amigo. Tenía un proyecto de sistema de gestión backend, plazo de un mes, y el precio era bastante bajo. Yo tenía prisa por empezar, no lo pensé mucho y lo acepté. El proyecto en sí no era difícil, solo tareas de crear, leer, actualizar y borrar. Usé React con Ant Design, con los ojos cerrados. Cuando terminé, lo ejecuté localmente, las pruebas pasaron, lo empaqueté y se lo envié al cliente.

Pasó medio día y el cliente me mandó una captura de pantalla por WeChat: "Hermano, tu código no lo entiendo muy bien, ¿puedes ordenarlo un poco?"

Me quedé helado. ¿Cómo que ordenar el código? Abrí la captura que me envió y casi me da un patatús. Resulta que había abierto directamente el archivo bundle.js que le envié empaquetado, que contenía el código comprimido y ofuscado por Webpack: una sola línea interminable de decenas de miles de líneas, con nombres de variables como a, b, c, d. A sus ojos, eso era un galimatías.

Le expliqué que estaba comprimido, para producción, que ocupaba menos y cargaba más rápido. Pareció entender a medias y volvió a preguntar: "¿Pero puedes darme una versión que se pueda leer? Si algún día quiero cambiar algo o pasarle el mantenimiento a otra persona, así no hay manera."

En ese momento me di cuenta de repente: lo que para mí era algo obvio, "comprimir y ofuscar", para el cliente era "este tío no es fiable, escribe código como la mierda". Él no sabe qué es Tree Shaking, ni qué es un AST (árbol de sintaxis abstracta). Solo entiende una cosa: el código debe ser legible para humanos.

Después aprendí la lección. Antes de cada entrega, reestructuro el código con una herramienta de formateo y compresión de JS. La herramienta es sencilla: restaura el código comprimido a un formato con indentación, saltos de línea y nombres de variables aunque sigan siendo cortos, al menos con una estructura clara. Luego genero un documento para que lo vea el cliente. A veces incluso formateo el código fuente con prettier, añado comentarios y lo envío todo junto.

¿Y sabes qué? Los siguientes encargos, la satisfacción del cliente subió como la espuma. Una chica que hace contenido para redes me pidió una pequeña herramienta; cuando recibió el código se puso contentísima y dijo: "Aunque no lo entiendo, se ve profesional". Otro cliente me recomendó directamente a un amigo, diciendo que este chico es meticuloso.

Esto me hizo reflexionar mucho tiempo. Los que trabajamos en tecnología caemos fácilmente en una especie de autoengaño: creemos que usar el framework más nuevo o escribir el algoritmo más ingenioso nos hace geniales. Pero lo que el cliente quiere es muy simple: que funcione, que si hay un problema se pueda contactar a alguien, y que el código no parezca un libro sellado. Sobre todo esos clientes que no entienden de tecnología; su criterio para juzgar si eres fiable a veces es simplemente si el código se ve ordenado.

Ahora, en mi proceso de aceptar encargos, formatear el código es un paso obligatorio. Aunque el proyecto sea pequeño, antes de entregar lo paso por la herramienta y genero una versión legible. A veces incluso escribo un README sencillo explicando cómo desplegar y cómo cambiar la configuración. Con ese pequeño esfuerzo extra, he conseguido varios clientes a largo plazo.

Entonces, ¿da miedo que te despidan de una gran tecnológica? Sí, da miedo. Pero a veces, mirándolo desde otro ángulo, precisamente por salir de ese entorno que solo mira KPI y OKR, entendí de verdad que la tecnología está para servir a las personas. Al cliente no le importa lo profundo que sea tu código, sino si puedes hacerle la vida fácil y darle tranquilidad. Y formatear el código es justamente ese pequeño interruptor que hace que el cliente sienta que "lo tomas en serio".

15 Vistas · 4 minutos

🔗 Related Tools

Try these practical tools related to this article

📝 Artículos relacionados

You might also like these articles

tool-tutorials

Descubre los entresijos del evento de Apple: los pequeños iconos son la primera clave para la identidad de marca

Lo más digno de analizar del evento de Apple son esos pequeños detalles. Ese discreto Favicon en la pestaña del navegador es la primera barrera para la identidad de marca. El usuario abre un montón de pestañas, ¿por qué va a encontrarte de un vistazo? Gracias a ese pequeño icono. Un icono borroso o deformado hace que el usuario lo considere poco fiable, mientras que uno nítido y sencillo hace que te recuerde. Con un generador de Favicon, en diez minutos resuelves la adaptación a todos los tamaños; no dejes que ese cuadradito arrastre tu marca hacia abajo.

09-15
tool-tutorials

La IA rastreadora convirtió la página web en un desastre, con este truco la limpié de una vez

El contenido web extraído por la IA rastreadora está lleno de etiquetas HTML y no se puede usar directamente. Este artículo comparte un truco práctico: usar una herramienta de conversión de HTML a Markdown para limpiar con un solo clic, transformando el código desordenado en un formato Markdown limpio y ordenado. La operación es simple, y después de la conversión los títulos, listas y enlaces quedan claros, listos para usar directamente en aplicaciones de notas. También se comparten consejos para elegir y usar la herramienta, para que evites caminos equivocados.

09-15
tool-tutorials

Aterrizaje de la nueva política de elementos de datos: esos desordenados datos de interfaz en las empresas ya deben ser gestionados

Con la implementación de la nueva política de elementos de datos, el problema del caos en los datos de interfaz de las empresas ya no se puede ocultar. El mismo campo con nombres diferentes, niveles de anidamiento insondables, documentación que no coincide con lo que realmente se devuelve... Estos desórdenes afectan directamente la gestión y trazabilidad de los datos. Las herramientas de formateo JSON parecen simples, pero son el primer paso para que los datos de interfaz pasen de ser "legibles por máquina" a "comprensibles también para humanos". Este artículo parte de casos reales para hablar de cómo usar herramientas de formateo para gestionar esos desordenados datos de interfaz en las empresas.

09-13