WP Engine es el proveedor de hosting gestionado de WordPress más grande del mundo. El 8% de todas las personas en línea visitan un sitio de WP Engine cada día. Mantener buena documentación es esencial a esa escala. Pero el equipo de WP Engine tenía un problema: estaban dedicando más tiempo a mantener el código de su documentación que a escribir documentación real. Algo tenía que cambiar.
Starlight es un tema de documentación con todas las funciones, ecológico y accesible por defecto construido sobre Astro. WP Engine eligió Starlight para construir su nuevo sitio de documentación para Atlas, la solución de hosting de WP Engine para aplicaciones Headless WordPress. Los resultados hablan por sí solos.
Starlight permitió al equipo de Atlas moverse el doble de rápido y redujo los costos de desarrollo en más del 50%. Hoy, el equipo dedica el 95% de su tiempo al contenido y casi cero tiempo al mantenimiento de código y configuración.
Desafíos
Había tres problemas principales que WP Engine tenía con su sitio de documentación anterior.
Primero, su documentación solía estar en un repositorio MDX separado de GitHub del shell de Next.js que procesaba esos archivos. Cada vez que se cambiaban los archivos MDX, no se activaban reconstrucciones automáticas del sitio ni vistas previas. Para solucionar esto, el equipo tenía un entorno de desarrollo dedicado donde probaban los cambios antes de desplegar. Sin embargo, esto significaba una gestión adicional de ramas de Git.
Segundo, tanto los cambios visuales como funcionales al sitio de documentación tardaban mucho tiempo. Además de eso, el sitio de documentación anterior no se veía muy bien y no tenía todas las características que querían que los usuarios tuvieran.
Tercero, debido a la solución de MDX a React, solo los desarrolladores podían contribuir. Esto impedía que contribuidores clave de la documentación como PMs o personal de soporte al cliente hicieran cambios por sí mismos.
Requisitos
Para resolver los tres grandes desafíos de WP Engine, necesitaban una solución con baja barrera de entrada que mejorara la facilidad de uso tanto para los mantenedores de la documentación como para los contribuidores. Necesitaba ser algo que eliminara el tiempo innecesario dedicado al desarrollo front-end como barrera para una buena documentación.
Afortunadamente para el equipo, Jeff Everhart, un developer advocate en WP Engine, conocía una solución.
Solución e Implementación
En agosto de 2023, Astro lanzó Starlight en Product Hunt para proporcionar un framework web de código abierto para construir sitios web de documentación modernos. Jeff estaba familiarizado con Astro pero no había tenido una buena razón para usarlo todavía. Starlight proporcionó la oportunidad perfecta.
Starlight era perfecto para WP Engine porque venía con cada elemento repetible que necesitaban. Incluía navegación, búsqueda, i18n, resaltado de sintaxis, modo oscuro y más listos para usar. Además, ¡cada elemento se veía bien! También había muchas opciones de personalización incluyendo la capacidad de especificar fácilmente logotipos para modo claro y oscuro. Todo esto era posible sin tener que escribir mucho CSS personalizado, si es que había que escribir algo. Esto haría posible que WP Engine se enfocara principalmente en escribir contenido en lugar de pasar varios sprints construyendo interfaces de usuario.
El framework Starlight también era una solución completamente estática que enviaba solo HTML. Esto redujo el tiempo de incorporación tanto para los mantenedores de la documentación como para los contribuidores al hacer cambios en el sitio porque ninguna de las dos partes tenía que aprender JavaScript ni React para publicar algo.
Migrar de su solución anterior a Astro fue virtualmente indoloro. Todo lo que el equipo de Jeff tuvo que hacer fue copiar la carpeta existente de ~100 archivos MDX en la plantilla de Starlight y ya tenían un sitio en vivo. Podían gestionar todo lo que necesitaban a través de un archivo de configuración y una hoja de estilos CSS simple. Requirió capacitación mínima para que su equipo de documentación se incorporara a Starlight debido a lo fácil que era de usar.
Resultados
Con la solución anterior de WP Engine, su equipo dedicaba más tiempo a gestionar el sitio de documentación que a trabajar con el contenido real. Si la proporción de escribir contenido vs. gestionar el sitio era de 30:70 antes, ahora estaba más cerca de 95:5. El framework Starlight de Astro redujo la fricción en tal magnitud que un PM del equipo de WP Engine dijo lo siguiente sobre el nuevo framework web:
“Simplemente es mucho mejor en términos de experiencia para nuestros clientes pero también me ahorró MUCHAS HORAS de mi vida que de otra manera tendría que pasar probando meticulosamente y dando forma a nuevas páginas para la documentación de Atlas.”
Las operaciones de contenido de WP Engine son más de 2x más rápidas como resultado de eliminar tantos procedimientos de Git y pasos de prueba manuales. Como el proceso es más fácil, las personas también están más dispuestas a contribuir. Starlight también ayudó a reducir sus costos de desarrollo en más del 50% porque proporcionó todos los elementos de UI que WP Engine necesitaba listos para usar. Mantener su solución actualizada también es significativamente más fácil que antes. Anteriormente, tenían que gestionar varias dependencias relacionadas con diferentes elementos de UI, es decir, menús desplegables. Como resultado, tenían muchos más tickets de Dependabot que resolver. Con Starlight, solo tienen que actualizar un único framework.
