README de GitHub: licencia y estructura para no perder visitas

Contenido
Mucha gente da por hecho que, si el código está publicado en un repositorio público y cualquiera puede verlo, entonces se puede usar sin más. Pero la guía oficial de GitHub dice otra cosa: en un repositorio sin archivo de licencia, aunque el código esté a la vista, legalmente el titular sigue conservando todos los derechos, y nadie ha recibido permiso para copiar, modificar, distribuir ni reutilizar ese código.
Resumen ① Que no haya archivo de licencia no significa "no hay reglas", sino que se aplica el valor por defecto más estricto (todos los derechos reservados) ② El README es lo único con lo que un visitante desconocido decide, en cuestión de segundos, si usa tu repositorio o no ③ Para que el visitante no se vaya, deben estar la presentación del proyecto, la instalación, los ejemplos de uso, la licencia y la forma de contribuir
Que el código esté a la vista no significa que puedas usarlo a tu antojo
Cuando publicas un repositorio en GitHub, cualquiera puede consultar el código. Por eso es fácil malinterpretar que "si está público, puedo usarlo libremente". Sin embargo, poder consultarlo y tener permiso para reutilizarlo son dos conceptos completamente distintos.
Según la guía oficial de GitHub, cuando un repositorio no incluye un archivo de licencia explícito, la situación legal por defecto es que el titular conserva intactos sus derechos exclusivos sobre ese código. Es decir, fuera de quien lo creó, nadie tiene permiso explícito para copiarlo, modificarlo o distribuirlo, ni siquiera para llevarlo a su propio proyecto.
Aquí hay un detalle que suele pasarse por alto: que no haya licencia no significa que "no se aplique ninguna regla". Es justo lo contrario. Sin licencia se aplica tal cual el valor por defecto más estricto del derecho de autor, es decir, "todos los derechos reservados por el titular". Por un solo archivo que falta, ese repositorio se convierte en la práctica en un código que "puedes mirar, pero no usar".
Cómo se ve un repositorio sin README
Al margen del tema de la licencia, un repositorio que no tiene README o que lo tiene pobre no le da al visitante ningún punto de apoyo para juzgar. Basta con imaginar un repositorio donde lo único que hay es una lista de archivos de código.
El visitante tiene que adivinar por su cuenta qué hace el proyecto, si le sirve para su problema, cómo se instala y si puede usar el código. La mayoría simplemente pulsa "atrás" en ese punto.
Hay un patrón de fracaso todavía más habitual: el README existe, pero lo único que contiene es el texto completo de la licencia copiado y pegado. Las condiciones legales quedan claras, pero en ninguna parte aparece qué hace el proyecto. El visitante solo sabe si tiene permiso para usarlo; sigue sin saber por qué ese código le resultaría útil.
Qué debe incluir un buen README y por qué
Si piensas en el momento en que un visitante desconocido llega por primera vez al repositorio, el orden se define casi solo.
- Presentación del proyecto (arriba del todo): en la primera pantalla debe quedar claro qué hace el proyecto y por qué hace falta. El visitante decide en cuestión de segundos si sigue leyendo o no.
- Cómo instalarlo: debe haber un comando de instalación que se pueda pegar tal cual en la terminal. Un "instálalo como te parezca" lleva directamente a que el visitante se vaya.
- Ejemplos de uso: un fragmento de código mínimo que funcione de verdad se entiende más rápido que una explicación larga. El visitante prefiere copiar el ejemplo y ejecutarlo antes que leer párrafos.
- Licencia: por las razones explicadas arriba, es la única forma de dejar claro si puedes usar este código o no.
- Cómo contribuir: si quieres recibir aportes externos, conviene explicar, aunque sea brevemente, cómo abrir un issue y qué reglas siguen los pull requests.
Cómo rellenar estos apartados a mano
Si escribes el README desde cero, tienes que colocar los cinco apartados en orden y ajustar a mano la sintaxis Markdown que corresponde a cada uno (niveles de encabezado, bloques de código, listas). Después de la presentación, encierra los comandos de instalación en un bloque de código, separa los ejemplos de uso en otro bloque y, si quieres añadir insignias, busca aparte la sintaxis de imagen enlazada de shields.io y pégala.
Y si además quieres incluir un índice, tendrás que cuadrar uno por uno los enlaces de ancla de cada título; el apartado de licencia cambia su redacción según el tipo de licencia que elijas. Ningún apartado es difícil por separado, pero reunirlos todos y darles un formato coherente lleva más tiempo del que parece.
Es un generador de README para GitHub: introduces los campos y te crea al momento un README.md completo, con insignias, índice y sección de contribución, listo para copiar y descargar.

Para reducir este trabajo repetitivo, es más rápido usar una herramienta en la que solo introduces el contenido de cada apartado y el formato se ajusta solo. Con nuestro generador gratuito, el Generador de README para GitHub, basta con indicar el nombre del proyecto, una descripción de una línea, la descripción detallada, la lista de funciones, el stack técnico, los comandos de instalación, el código de ejemplo, el tipo de licencia, el autor y la dirección del repositorio para que el README.md completo se genere al momento, con insignias, índice y sección de contribución según lo actives.
Por qué importa elegir el tipo de licencia
Si no tener licencia equivale a "todos los derechos reservados", en cuanto añades una, la reutilización pasa a estar permitida bajo las condiciones que esa licencia establece. Las condiciones varían mucho según cuál elijas, así que conviene escoger la que encaje con la naturaleza del proyecto.
| Licencia | Características |
|---|---|
| MIT | Es la de condiciones más simples y permite ampliamente el uso comercial, la modificación y la distribución |
| Apache-2.0 | Similar a MIT, pero incluye de forma explícita cláusulas relacionadas con patentes |
| GPL-3.0 | Obliga a que las obras derivadas que usen este código se publiquen también con la misma licencia |
| BSD-3-Clause | Parecida a MIT, aunque añade una cláusula que limita la promoción usando el nombre del autor |
No se puede afirmar que una licencia sea "la mejor". La elección depende de con cuánta libertad quieres liberar el proyecto y de si quieres imponer las mismas condiciones a las obras derivadas; es una decisión que depende de la intención del titular, no un terreno con una respuesta única.
En resumen
- Un repositorio público sin archivo de licencia no está autorizado para reutilizarse aunque el código se vea, y este es el principio básico que GitHub indica de forma oficial
- "Sin licencia" no significa "sin reglas", sino que se aplica el valor por defecto más estricto (todos los derechos reservados)
- El README debe seguir el orden presentación del proyecto, instalación, ejemplos de uso, licencia y forma de contribuir para acompañar el proceso de decisión del visitante
- Un repositorio que solo tiene código y ningún README, o que solo tiene el texto de la licencia y ninguna presentación, lleva a que el visitante se vaya
- El tipo de licencia no es una cuestión de mejor o peor, sino de cuánto quieres abrir las condiciones de reutilización
Es un generador de README para GitHub: introduces los campos y te crea al momento un README.md completo, con insignias, índice y sección de contribución, listo para copiar y descargar.
Preguntas frecuentes
¿El código queda protegido por derechos de autor solo por subirlo a GitHub?
Sí: los derechos de autor existen desde el momento en que escribes el código. La clave está en que, sin archivo de licencia, no has dado permiso a nadie para reutilizarlo. La protección legal y el permiso de reutilización son dos asuntos distintos.
¿Puedo usar en mi proyecto personal el código de un repositorio ajeno que no tiene licencia?
En principio, lo más seguro es no usarlo sin un permiso explícito del titular. Si no hay archivo de licencia, significa que no hay condiciones de reutilización definidas, así que, si quieres usarlo, lo más seguro es preguntar directamente a quien administra el repositorio o buscar un código alternativo que indique su licencia.
¿Es obligatorio incluir un índice (TOC) en el README?
No es obligatorio, pero cuanto más largo sea el README, más útil resulta. Permite al visitante ir directamente al apartado que busca (instalación, uso, licencia, etc.) sin recorrer el documento entero. En un proyecto corto puedes omitirlo sin problema.
¿Puedo cambiar la licencia más adelante?
Si eres el titular y sigues manteniendo el repositorio, cambiar el texto de la licencia es posible. Eso sí, no se aplica de forma retroactiva a quienes ya se llevaron el código bajo las condiciones anteriores, así que conviene dejar constancia clara en el README o en el historial de commits de cuándo y por qué lo cambiaste.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano