Construyendo una comunidad de builders

Por
Sarah Rainsberger
Elian Van Cutsem

Astro continúa evolucionando cómo trabaja con y para su comunidad.

Nuestros community awards nos permiten devolver algo a quienes voluntarian su tiempo enviando código y bug fixes, siendo acogedores y útiles en los support threads, traduciendo los docs, y enriqueciendo la experiencia de Astro de todos.

Anteriormente un evento trimestral, Astro recientemente se comprometió a emitir estos awards de manera mensual. También cambiamos de awards nominados por pares a destinatarios elegidos por nuestros core maintainers.

Esto puede sonar menos democrático, pero lo pensamos como un diario de gratitud de los maintainers: nos aseguramos de que nuestros core maintainers estén activamente reflexionando y buscando a la próxima generación de up-and-comers. Estamos orgullosos de decir que dedicamos tiempo a la salud, el crecimiento y la sustainability de nuestra comunidad open-source.

Un community award es agradable, pero hasta ahora, este reconocimiento se ha mantenido principalmente dentro de nuestra comunidad. Queríamos un lugar mejor, más público y más permanente para el reconocimiento comunitario. Un lugar donde pudieras presumir ante amigos y familia, ¡quizás para explicar dónde se fueron todas esas noches y fines de semana!

Estamos encantados de anunciar el lanzamiento de nuestro primer espacio público de comunidad: https://community.astro.build construido por nuestro primer Community Engineer, Elian van Cutsem.

Hoy, puedes visitar y celebrar a las personas que ayudaron a hacer de Astro el proyecto que amas usar. ¡Estén atentos a más iniciativas comunitarias emocionantes que encontrarán un hogar allí a medida que crecemos y extendemos el sitio!

Una captura de pantalla del Astro Community Microsite

Maintainer Projects

Cada semana en nuestras community calls destacamos y celebramos todas las cosas que nuestra comunidad construye con Astro. Hoy, queremos reconocer un tipo muy especial de contribución comunitaria que normalmente no verías: los experimentos personales y side projects que nuestros propios maintainers construyen para trabajar en y contribuir a Astro

Mantener un proyecto open-source significa pasar mucho tiempo en nuestros code editors, en PRs, y en GitHub, buscando cosas en los docs, haciendo seguimiento del work-in-progress, y colaborando con otros.

Nos gustaría mostrar algunas de estas herramientas que hemos construido para nuestro propio uso mientras construimos Astro para (y con!) vosotros. Algunas hacen las tareas rutinarias más fáciles, y otras simplemente las hacen más divertidas… ¡porque eso también es parte del objetivo!

Maintainer Projects Showcase

Astro Docs Docs (AD²)

contribute.docs.astro.build

Creado por Sarah

¡Haciendo docs de los Astro Docs! Un sitio entero lleno de guías y recursos para contribuir a los Docs de Astro.

¡Tengo un problema con Starlight! Este proyecto empezó como una forma más fácil de organizar y escribir que actualizar nuestras guías existentes como archivos Markdown planos en el repo de GitHub. Cada vez que necesito organizar información, creo un nuevo proyecto de Starlight. Un shout out a Yan Thomas por proporcionar todo nuestro contenido i18n. Agradecimiento especial a Chris Swithinbank por su ánimo y apoyo, y por insistir en que esto debería ser realmente un sitio desplegado para el proyecto Astro.

Raycast Extension

Raycast Store

Creado por Elian

Accede y busca en la Astro Documentation al instante directamente desde Raycast sin ningún problema. Soporta todos los idiomas que la Astro Documentation soporta y tiene todos los enlaces del sidebar que la Astro Documentation tiene.

Como docs editor, me encontraba constantemente teniendo que navegar manualmente a la Astro Documentation y buscar las páginas correctas. Uso Raycast todo el tiempo, así que pareció una buena solución crear una extensión que acelerara mi proceso de writing & reviewing de docs.

Creado por Marijn Kneppers

¡Deja que el bot lo haga por ti! Desde crear una PTAL request hasta navegar los docs, Houston Bot está ahí para hacer la vida de todos los que trabajan en/con Astro más fácil

Como miembro del support squad, me molestaba tener que cambiar a un navegador para buscar en los docs, así que escribí un bot con un comando /docs que me permitía navegar los docs desde Discord. Esto llevó a un comando /ptal (Please Take A Look) para dar a los maintainers una visión más fácil del status de un pull request.

Starlight i18n

VSCode Marketplace

Creado por HiDeoo

Extensión de Visual Studio Code para traducir fácilmente páginas de documentación de Starlight usando el soporte integrado para sitios multilingües y git.

Poder elegir un idioma soportado para traducir desde una configuración de Starlight en un workspace repo y tener editores side-by-side con los cambios faltantes y la página traducida parecía una buena idea, y lo he estado usando para todas las traducciones que he enviado a la documentación de Starlight hasta ahora.

Creado por Hippotastic

Expressive Code es un motor para presentar código fuente en la web, con el objetivo de hacer tu código fácil de entender y visualmente impresionante. Además del syntax highlighting preciso powered by el mismo motor que VS Code, Expressive Code te permite anotar code blocks usando text markers, diff highlighting, code editor & terminal window frames, y más.

Después de que inicialmente construí estas features en los Docs de Astro, los usuarios seguían preguntándonos cómo podían usar nuestros code snippets en sus propios proyectos. Esto me llevó a crear Expressive Code como un proyecto standalone, que de hecho se convirtió en mi primer set publicado de paquetes NPM. ¡Estoy realmente feliz de que ya se esté usando en los Docs de Astro, Starlight, y muchos sitios web individuales.

Creado por Yan Thomas

Lunaria es una toolchain de localization management para proyectos open-source, que permite a los maintainers y contributors hacer seguimiento del progreso de sus proyectos de localization de manera sostenible y gratis.

Lunaria surgió del deseo de compartir el Astro Docs custom i18n translation status tracker, originalmente construido por @hippotastic, con la comunidad open-source más amplia. Lunaria fue construido para compatibilidad general y es adecuado para una amplia gama de diferentes content strategies, frameworks, e incluso git hosting platforms.

Creado por Kevin & Otterlord

Crea mensajes de co-author para acreditar a los contributors 💜. Esta herramienta recolecta los participantes del PR y crea un string de co-author formateado para git commits.

En Astro, valoramos mucho reconocer a nuestros contributors. Nuestro método anterior implicaba bastante trabajo manual para buscar la git signature de un individuo en GitHub para poder añadirlo a un PR commit. Ocasionalmente, este proceso tomaba más tiempo que el PR actual, pero era un esfuerzo que valía la pena para mostrar aprecio a nuestra comunidad.

Creado por Alexander Niebuhr

Integración brand-new que añade un external remote image service a `astro:assets`. Tus imágenes obtendrán una URL remota que las optimiza, similar a servicios de digital asset management de pago… pero gratis, si tienes un proyecto de Astro. Funciona con cada Astro adapter y hosting provider.

External Remote Image Optimization es complejo de configurar o cuesta demasiado. Hacer esto disponible para todos los usuarios de Astro gratis hace que la Image story de Astro sea mucho mejor. Lo más complejo de hacer bien es la autorización: cómo asegurarse de que solo los usuarios de Astro puedan usarlo gratis y tener una política de fair-use en su lugar.

Creado por Erika

Un dashboard que muestra stats sobre todos los issues en cada repo de Astro. La idea es que al poder visualizar el total de issues como algo gráfico, “gamificará” el acto de reducir el issue count.

Después de ver el issue dashboard, Docs y Starlight sintieron la presión de hacer triage de sus issues y aceptaron el desafío. Esto redujo el total de issues de Astro en 50 solo una semana después de que lanzara el sitio web. (*Nota del editor: Bien jugado, Erika.)

Creado por Otterlord

Ver versiones de paquetes NPM, y calcular un semver range. Útil para calcular rangos para compatible peer dependencies.

Puedes ver el uso entre paquetes en el dashboard público de Plausible.

Creado por Nate & Chris

Un repositorio centralizado para GitHub Action workflows reutilizables. Estas actions nos ayudan a automatizar workflows comunes entre muchos repositorios diferentes en la organización de GitHub withastro. El mayor beneficio de tener workflows comunes en una sola ubicación es que el mantenimiento ocurre en un solo lugar y se despliega automáticamente a todos nuestros repositorios. Los centralized workflows también hacen mucho más fácil configurar automated workflows para repositorios nuevos.

Cuando empezamos a construir Astro, teníamos un monorepo central de Astro para todo nuestro código y documentación. Esto hacía fácil compartir tooling y configuración pero se volvió cada vez más difícil colaborar en muchas áreas de enfoque diferentes a medida que el proyecto crecía. Mientras que copiar y pegar archivos de workflow funciona para un pequeño puñado de repositorios, el número de repositorios empezó a crecer en el verano de 2023. Este repositorio de automation es usado por todos nuestros repositorios para compartir merge notifications en nuestro Discord (congratsbot), formatear nuestro código fuente con Prettier (format), y automatizar el issue labeling (issue-opened e issue-labeled)

Creado por Nate Moore

Un theme de Visual Studio Code Astro-branded con cool blues, minty greens, y soft purples y la mascota de Astro, Houston.

Los brand colors de Astro pedían a gritos ser convertidos en un syntax highlighting theme. Con algunos ajustes de contrast y legibility, estoy bastante feliz de que este pequeño experimento haya salido tan bien. Este theme ha sido descargado por 12.5K personas en el Visual Studio Code marketplace* y es el theme por defecto para el documentation framework Starlight de Astro. (*Nota del editor: ¡y 169 en el OpenVSX registry! 😉)

Creado por happydev

Un playground para el Astro compiler que genera previews insightful del compiled output de los componentes de Astro.

Surgido por la dificultad de detectar rápidamente compiler bugs, construí esto para ahorrar tiempo en issue troubleshooting. En lugar de meterse directamente a escribir tests, ahora podemos simplemente tirar algo de código en el playground, revisar el output, y detectar y mostrar a otros fácilmente qué está fallando — ¡haciendo que toda la danza del debugging sea mucho más fluida!

Astro Badges

astro.badg.es

Creado por Chris

Astro Badges celebra a los contributors de Astro con imágenes embeddable que muestran achievements desbloqueados por actividad en GitHub en la organización withastro. ¡Desde Little Green Bug hasta Constellation Crafter, cada uno de los casi 3.500 contributors de Astro está aquí!

Astro Badges empezó como un proyecto de fin de semana después de notar que el dominio badg.es estaba disponible. Ha crecido mucho desde entonces, incluyendo un full redesign en colaboración con la diseñadora de Astro, @doodlemarks. Probablemente lo más challenging de mantenerlo es inventar nombres divertidos para los achievements, ¡aunque @sarah11918 siempre está dispuesta a workshoparlos! Mi adición reciente favorita probablemente sea el achievement SSRsly para personas que trabajan en los serverless adapters de Astro. Shout out a @Yan-Thomas, @ElianCodes, @natemoo-re, @mayank99, @torn4dom4n, @jacobthesheep, y @TheOtterlord por contribuir en el camino 🙌