Volver al journal

Open source

GitHub es el taller. La puerta para el resto del mundo es otra

Un periodista, una diseñadora que te vio en un vídeo y quien responde por un fallo de seguridad no viven en tu perfil de commits. Docs, sponsors, aviso de seguridad y una frase de persona, en HTML.

30 de octubre de 202612 minLinkForge Editorial

GitHub es donde vive el trabajo. Es una portada pésima para un periodista, para una diseñadora que te encontró en un vídeo o para quien busca un aviso de seguridad después de un CVE. Necesitan una puerta en HTML: qué es el proyecto, cómo pagarte, cómo avisar de un agujero y que detrás hay una persona, no una botnet.

Una fila de Discord, merchandising y un botón de estrella enterrado enseña a quien no programa a irse.

El escritorio del maintainer en LinkForge: créalo. Pro son 7€ al mes si quieres oss.tunombre.com.

Cuatro personas, cuatro botones

Quien usa el proyecto: documentación o inicio rápido. Nunca primero tu drama personal de mecenazgo.

Quien patrocina: GitHub Sponsors u Open Collective. Nunca primero una pila de cuarenta enlaces.

Quien avisa de un fallo: security.md o un formulario privado. Nunca un Discord público.

Quien escribe o quiere contratarte: una bio de unas noventa palabras y las charlas. Nunca la tienda de camisetas.

Eso le sirve a quien mantiene una librería desde Barcelona y a quien la mantiene desde Montevideo. El README está en inglés técnico. La puerta puede tener un párrafo en la lengua en la que contestas el correo.

Texto que un rastreador puede leer

Una línea de qué es el proyecto, sin sopa de eslóganes. La licencia. El estado del mantenimiento: activo, lo que se puede, o buscas a alguien que comparta la carga. La versión mínima de Python o de Node, si es relevante. Cómo aceptas dinero, y que el dinero no compra un commit.

Un canal público llamado #security es una forma de que te rompan el proyecto en voz alta. Enlaza un formulario privado o un correo. Si tienes dominio en Pro, puedes publicar security.txt ahí. No pegues tokens. No pegues los pasos para reproducir un fallo que todavía no está parcheado.

Dos tipos de sponsor que no son fans

Hay empresas que patrocinan para poner un logo en el README. Enséñales el kit de marca y cómo se factura. Hay gente que patrocina porque le caes bien. Enséñales una frase humana. Juntar las dos cosas en un botón llamado «apoyar» está bien. Juntarlas con una emisión de cripto es como se pierde la empresa, en un departamento de compras en Madrid y en uno en São Paulo.

El README es para quien clona. El hub es para quien no va a clonar nunca. Duplica la línea de qué es el proyecto. No dupliques la arquitectura entera.

El perfil README de GitHub ayuda a quien ya está en GitHub. No se busca tu nombre como se busca una página en tu dominio o en LinkForge. Fija tres repositorios. Enlaza la organización para el resto. El Discord, si existe, va segundo. Lo primero son los docs y las plantillas de issues, para no convertirte en un mostrador de soporte.

Si esta semana además lanzas en Product Hunt, el hub de lista de espera y changelog puede enlazar aquí. No lo sustituyas: quien llega del festivo y quien llega de un CVE no buscan el mismo botón.

Cuando escribe alguien que no va a clonar

Una redacción en Madrid puede pedirte una frase sobre qué hace la librería y si el mantenimiento sigue vivo. No van a leer el changelog de dependencias. El hub ya tiene esa frase: cópiala, no improvises otra en el correo que contradiga la página. Si el estado es «lo que se puede», dilo también en el correo. Prometer un SLA que no existe es cómo se rompe la confianza con quien luego te cita.

Una diseñadora en Montevideo que quiere integrar el proyecto necesita el inicio rápido y la licencia, no tu hilo de opiniones. Si el botón de docs abre un README de cuatrocientas líneas sin una primera pantalla de «cómo probarlo en diez minutos», añade esa pantalla en la documentación y enlázala. El hub no reescribe el manual. Señala la puerta corta.

Quien patrocina desde una empresa pide factura y logo. Ten el camino escrito: qué datos de facturación, en qué moneda, y que el logo no implica un commit a medida. Quien patrocina a título personal ve la frase humana. Si contestas las dos cosas con el mismo «DM me», las dos se enfrían.

El aviso de seguridad sigue fuera del hub público: formulario o correo, sin pasos de reproducción de un fallo abierto. En la página basta la dirección y la promesa de que lees eso antes que el Discord.

Cuatro botones. Crea la página.

Crear mi página — Pro 7€/mes

Gratis para empezar. Pro a 7€ / mes.