AI WORLD HQCrea un README impecable con GitHub Copilot
Aprovecha el autocompletado con IA de Copilot para redactar una descripción clara del proyecto, instrucciones de instalación y ejemplos de uso, sin escribir todo desde cero.
Esta guía fue escrita por IA. Pasó controles automáticos de datos y calidad, y nuestro editor comprueba cada día una muestra de las guías publicadas.
Ve primero AI World HQ en GoogleAñádenos como fuente preferida y verás nuestras noticias antes en las Noticias destacadas de Google.Añadir en GoogleAl terminar esta guía, tendrás un archivo README con apariencia profesional listo para tu proyecto, y habrás usado la IA de GitHub Copilot para generar el texto sin tener que escribir frases completas tú mismo. Es perfecto si estás empezando a programar, o simplemente quieres crear una descripción ordenada para un proyecto personal y compartirlo con los demás.
💡 Consejo: toca el número de un paso cuando lo termines — aparece una marca verde y tu navegador recuerda hasta dónde llegaste.
- Una cuenta gratuita de GitHub: Si todavía no tienes una, regístrate en
github.com. Aquí es donde vivirá el código de tu proyecto en una carpeta especial online. - Un repositorio que puedas editar: Es como una carpeta digital en GitHub que contiene todos los archivos de tu proyecto. Asegúrate de tener uno creado y abierto.
- Visual Studio Code (VS Code): Un editor de texto muy popular y gratuito donde vas a trabajar. Lo puedes descargar desde
code.visualstudio.com. - La extensión de GitHub Copilot para VS Code: Es el asistente de IA que vamos a usar. Tienes que instalarla dentro de VS Code. GitHub Copilot ofrece un plan gratuito para usuarios individuales, y un plan de pago si necesitas más límites.
- Tiempo total aproximado: Seguir esta guía te llevará unos 15-20 minutos.
Abre o crea tu archivo README
El primer paso es abrir el archivo especial README.md dentro de tu proyecto. Si todavía no existe, tendrás que crearlo. La parte .md significa que es un archivo Markdown, una forma sencilla de dar formato al texto (crear títulos, listas o poner palabras en negrita) que GitHub entiende.
Para hacerlo, mira el panel Explorador en el lado izquierdo de tu ventana de VS Code: ahí verás todos los archivos y carpetas de tu proyecto. Si no lo ves, pulsa Ctrl + Shift + E (en Windows/Linux) o Cmd + Shift + E (en Mac) para mostrarlo.
Acción: En el panel Explorador, haz clic derecho sobre la carpeta principal de tu proyecto y elige "New File". Escribe README.md exactamente como se muestra y pulsa Enter.
Qué verás: Aparecerá un campo para escribir el nombre del archivo en el panel Explorador.
Qué ocurrirá después: El nuevo archivo README.md se abrirá como un documento en blanco en el área principal del editor de VS Code.
**** aparezca un archivo en blanco llamado README.md en el área principal del editor de VS Code, listo para que escribas en él.
**** Si ya tienes un archivo README.md, simplemente haz clic sobre él en el panel Explorador para abrirlo y, si quieres empezar de cero, borra el texto que tenga.
Empieza la descripción de tu proyecto
Ahora que tu archivo README.md está abierto, le vamos a pedir a Copilot que ayude a escribir la descripción principal. GitHub Copilot usa lo que se llama "autocompletado", parecido al texto predictivo de tu móvil, pero mucho más inteligente. Usa inteligencia artificial (IA) para adivinar lo que quieres escribir a continuación según el contexto.
Acción: Coloca el cursor parpadeante en la primera línea de tu archivo README.md, escribe un título breve para tu proyecto y pulsa la tecla Enter.
Qué verás: Después de escribir el título, normalmente aparecerá una sugerencia de Copilot en gris justo después del cursor.
Qué ocurrirá después: Copilot leerá tu título corto y empezará automáticamente a sugerir un párrafo completo describiendo tu proyecto. Si la sugerencia te parece buena, pulsa la tecla Tab para aceptarla. Si quieres ver otra opción, pulsa Ctrl + Space (en Windows/Linux) u Option + Space (en Mac) para ir pasando entre sugerencias hasta encontrar la que te guste.
También puedes escribir algunas palabras más por tu cuenta antes de volver a pulsar Enter.
**** Copilot muestre una sugerencia de texto en gris directamente en el editor y hayas aceptado la descripción pulsando Tab.
**** Si Copilot no ofrece una sugerencia enseguida, asegúrate de que la extensión de GitHub Copilot esté activada (comprueba en la esquina inferior derecha de VS Code si hay un pequeño icono de Copilot).
Genera una guía de instalación
La mayoría de proyectos necesitan instrucciones para configurarlos. Copilot también puede generar estas secciones comunes. A menudo detecta con bastante acierto en qué lenguaje de programación está tu proyecto mirando otros archivos del repositorio y sugiere los comandos adecuados.
Acción: Mueve el cursor unas líneas hacia abajo (pulsa Enter varias veces para hacer espacio), escribe ## Installation, pulsa Enter, luego escribe un pequeño indicio como Run the following command: y vuelve a pulsar Enter.
Qué verás: Tu nuevo título, seguido de tu indicio y después una sugerencia en gris con un comando de instalación.
Qué ocurrirá después: Normalmente Copilot completará automáticamente un comando de terminal (un comando que escribirías en la terminal del ordenador), como npm install (para proyectos en JavaScript) o pip install -r requirements.txt (para proyectos en Python).
Por ejemplo, Install Python dependencies: si te sugirió npm install para un proyecto en Python.
**** Copilot sugiera un comando para instalar dependencias y lo hayas aceptado pulsando Tab.
**** Si el comando sugerido no coincide con el lenguaje o el gestor de paquetes (la herramienta que se encarga de los componentes del software) de tu proyecto, simplemente bórralo y escribe un indicio más específico.
Añade un ejemplo de uso
Una vez que el proyecto está instalado, ¡la gente necesita saber cómo usarlo! Podemos seguir un patrón parecido para que Copilot genere un comando que inicie tu aplicación.
Acción: Después de la sección de instalación, mueve el cursor unas líneas hacia abajo, escribe ## Usage, pulsa Enter, luego escribe un breve indicio como Start the app with: y pulsa Enter.
Qué verás: Tu nuevo título e indicio, seguidos del comando sugerido por Copilot.
Qué ocurrirá después: Copilot propondrá un comando como npm start o python app.py, otra vez según lo que deduzca de tu proyecto. Acepta el que sea correcto pulsando Tab.
También puedes añadir una pequeña descripción en lenguaje claro debajo del comando para aclarar qué hace, por ejemplo: "Esto inicia el servidor local en http://localhost:5000".
**** Copilot ofrezca un comando para poner en marcha tu proyecto y lo hayas aceptado.
**** Si el comando sugerido no es del todo preciso, puedes acceptarlo y luego editar la línea manualmente para que sea exacto en tu proyecto.
Incluye una descripción general del proyecto
Un buen README suele terminar con un breve resumen de lo que el proyecto quiere conseguir o qué tecnologías clave utiliza. Vamos a pedirle a Copilot que nos dé una descripción rápida.
Acción: Mueve el cursor unas líneas hacia abajo desde la sección de uso, escribe ## Overview, pulsa Enter, luego escribe algunas palabras descriptivas como This project demonstrates... y pulsa Enter.
Qué verás: Tu nuevo título ## Overview, seguido de tu indicio y después una sugerencia de resumen más detallada de Copilot.
Qué ocurrirá después: Copilot completará un párrafo conciso que resume el propósito y los puntos destacados de tu proyecto.
**** Copilot te dé un párrafo corto y descriptivo resumiendo tu proyecto, y puedas aceptarlo.
**** Si el resumen es demasiado genérico, puedes añadir palabras clave más concretas a tu indicio inicial (por ejemplo, This project demonstrates data fetching and UI components...) para guiarlo hacia una respuesta más ajustada.
Termina con una nota sobre la licencia
Es una buena práctica indicar la licencia de tu proyecto. Esto le dice a los demás cómo pueden usar, modificar y distribuir tu código. La Licencia MIT es una opción muy habitual y permisiva para proyectos de código abierto.
Acción: Debajo de la sección Overview, añade un nuevo título escribiendo ## License y pulsa Enter. En la siguiente línea, escribe This project is licensed under the MIT License.
Qué verás: El nuevo título y la declaración de la licencia aparecerán en tu archivo README.md.
Qué ocurrirá después: Ya has completado las secciones esenciales de tu archivo README. Copilot normalmente no genera automáticamente el texto exacto de una licencia a menos que se lo pidas mucho, así que es buena idea añadir una habitual manualmente.
**** la sección ## License esté visible y completa en tu archivo README.md.
**** Si necesitas una licencia distinta, busca en internet textos de licencias comunes (por ejemplo, "Apache 2.0 License text") y copia la declaración correspondiente en esta sección.
- Aceptar sugerencias sin revisarlas: Copilot es un asistente de IA, no un lector de mentes. Puede adivinar mal el lenguaje de programación o sugerir comandos que no encajan del todo con tu proyecto concreto. Revisa siempre con cuidado el texto y los comandos generados, y ajústalos manualmente para asegurarte de que sean correctos.
- Indicios vagos o inexistentes: Si escribes un indicio muy corto o poco claro (por ejemplo, solo
App:), a Copilot le costará ofrecer una sugerencia útil. Dale siempre una frase o expresión breve pero clara que marque el contexto de lo que quieres que genere, comoStart the application with: - Olvidar el formato Markdown: Markdown usa símbolos especiales como
#para los títulos. Si se te olvida ponerlos, tu texto aparecerá como texto plano en vez de como un título con formato. Usa la vista previa de Markdown de VS Code (normalmente un icono en la parte superior derecha del editor que parece dos páginas superpuestas) para ver cómo quedará tu README.
❓ Preguntas rápidas
¿Cuánto tiempo lleva?
Unos 6 minutos — la guía tiene 6 pasos y puedes ir marcándolos a medida que avanzas.
¿Qué herramienta necesito?
Esta guía usa GitHub Copilot — pero el método funciona de forma muy parecida en otros asistentes de IA.
¿Necesito preparar algo?
- Una cuenta gratuita de GitHub: Si todavía no tienes una, regístrate en
github.com. Aquí es donde vivirá el código de tu proyecto en una carpeta especial online. - Un repositorio que puedas editar: Es como una carpeta digital en GitHub que contiene todos los archivos de tu proyecto. Asegúrate de tener uno creado y abierto.
- Visual Studio Code (VS Code): Un editor de texto muy popular y gratuito donde vas a trabajar. Lo puedes descargar desde
code.visualstudio.com. - La extensión de GitHub Copilot para VS Code: Es el asistente de IA que vamos a usar. Tienes que instalarla dentro de VS Code. GitHub Copilot ofrece un plan gratuito para usuarios individuales, y un plan de pago si necesitas más límites.
- Tiempo total aproximado: Seguir esta guía te llevará unos 15-20 minutos.
¿Qué errores debo evitar?
- Aceptar sugerencias sin revisarlas: Copilot es un asistente de IA, no un lector de mentes. Puede adivinar mal el lenguaje de programación o sugerir comandos que no encajan del todo con tu proyecto concreto. Revisa siempre con cuidado el texto y los comandos generados, y ajústalos manualmente para asegurarte de que sean correctos.
- Indicios vagos o inexistentes: Si escribes un indicio muy corto o poco claro (por ejemplo, solo
App:), a Copilot le costará ofrecer una sugerencia útil. Dale siempre una frase o expresión breve pero clara que marque el contexto de lo que quieres que genere, comoStart the application with: - Olvidar el formato Markdown: Markdown usa símbolos especiales como
#para los títulos. Si se te olvida ponerlos, tu texto aparecerá como texto plano en vez de como un título con formato. Usa la vista previa de Markdown de VS Code (normalmente un icono en la parte superior derecha del editor que parece dos páginas superpuestas) para ver cómo quedará tu README.
Sigue leyendo
✦ Generada por IA en la redacción automática de AI World HQ, en lenguaje claro. Pasó controles automáticos de datos y calidad, y nuestro editor comprueba cada día una muestra de las guías publicadas. ¿Ves un error? Usa los botones de arriba.
← Volver a las noticias