Merge pull request #196 from github-samples/motz-copilot-review-eligibility

docs: clarify first-steps review access and app workflows

Author: jamesmontemagno

docs/es-es/first-steps/copilot-app/0-prerequisites.md

@@ -24,6 +24,9 @@ Necesitas:
 - un plan activo de Copilot. [Activa Copilot Free o un plan de pago de Copilot][copilot-plans]. Si tu organización ya te proporciona acceso a Copilot, utiliza esa cuenta.
 - un ordenador con macOS, Windows o Linux.
 
+> [!IMPORTANT]
+> Copilot Free no incluye la revisión de código de Copilot para solicitudes de incorporación de cambios. La solicitud de revisión de la [lección 8][review-lesson] requiere [acceso a la revisión de código de Copilot][code-review]. Si no tienes acceso, sigue la alternativa de revisión manual de esa lección.
+
 La aplicación incluye Git, así que no hay nada más que instalar.
 
 > [!NOTE]
@@ -75,4 +78,6 @@ Has comprobado los requisitos previos, instalado la aplicación, elegido un mode
 [copilot-plans]: https://github.com/features/copilot/plans
 [download-app]: https://gh.io/app
 [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing
+[review-lesson]: ../8-review-loop/
+[code-review]: https://docs.github.com/copilot/concepts/agents/code-review
 [next-lesson]: ../1-create-workspace/

docs/es-es/first-steps/copilot-app/3-inspect-and-test.md

@@ -3,33 +3,36 @@ title: "Lección 3 - Inspeccionar la sesión y probar el cuestionario"
 description: "Lee los detalles de la sesión para confirmar en qué trabaja el agente y ejecuta una prueba de humo en el explorador antes de que Git escriba nada."
 authors:
   - jamesmontemagno
-lastUpdated: 2026-09-28
+lastUpdated: 2026-10-05
 ---
 
 Ahora que la sesión ha realizado trabajo real, ya hay algo que inspeccionar. Confirma sobre qué está trabajando el agente y, después, deja que maneje el cuestionario en el explorador integrado e informe de lo que ha ocurrido realmente, no de lo que pretendía hacer.
 
 En esta lección:
 
 - leerás el panel de detalles de la sesión.
-- comprobarás el proyecto, la ruta, la rama, los cambios y el uso del contexto de la sesión.
+- comprobarás el proyecto, la ruta y el uso del contexto de la sesión.
 - ejecutarás una prueba de humo en el explorador y corregirás los fallos.
 
 ## Lee los detalles de la sesión
 
 Los detalles de la sesión te indican exactamente en qué trabaja el agente. No necesitas vigilar este panel constantemente, pero todo lo que contiene importa cuando un resultado te sorprende.
 
-![Ilustración del panel de detalles de la sesión de la aplicación Copilot para la sesión de creación de Space Quiz. Muestra la rama main desde origin/main, la ruta, el proyecto, el nombre y el ID de la sesión, el agente, un archivo modificado, los recuentos de tokens, un uso del contexto del 27 %, el gasto de la sesión y opciones para habilitar el control remoto, cambiar el nombre, ver información, compartir como gist secreto o archivar la sesión.](../../../_images/first-steps-app-session-details.svg)
+En este momento, Space Quiz sigue siendo una carpeta local, no un repositorio de Git. Comprueba el proyecto, la ruta y el uso del contexto. Después de [publicar el proyecto en la lección 5][publish-lesson], las sesiones vinculadas a Git muestran detalles adicionales, como la rama y **Changes**.
 
-El panel muestra dónde se realiza el trabajo, qué ha cambiado y cuánto se ha llenado la ventana de contexto. No hay ninguna fila de modelo, porque eliges el modelo para cada solicitud en el cuadro de redacción.
+La ilustración siguiente muestra una sesión posterior vinculada a Git. Los campos de rama y **Changes** todavía no están disponibles en tu sesión de carpeta local.
 
-1. Confirma que **project**, **path** y **branch** corresponden al proyecto, la ruta y la rama que crees estar editando.
-2. Lee **Changes** para ver si esta sesión ha modificado algo.
-3. Comprueba **context usage**. A medida que aumenta, al agente le queda menos espacio para tu tarea, y esa es la señal para iniciar una sesión nueva.
+![Ilustración del panel de detalles de la aplicación Copilot para una sesión de Space Quiz vinculada a Git. Muestra la rama main desde origin/main, la ruta, el proyecto, el nombre y el ID de la sesión, el agente, un archivo modificado, los recuentos de tokens, un uso del contexto del 27 %, el gasto de la sesión y opciones para habilitar el control remoto, cambiar el nombre, ver información, compartir como gist secreto o archivar la sesión.](../../../_images/first-steps-app-session-details.svg)
+
+El panel muestra dónde se realiza el trabajo y cuánto se ha llenado la ventana de contexto. No hay ninguna fila de modelo, porque eliges el modelo para cada solicitud en el cuadro de redacción.
+
+1. Confirma que **project** y **path** corresponden al proyecto y la ruta que crees estar editando.
+2. Comprueba **context usage**. A medida que aumenta, al agente le queda menos espacio para tu tarea, y esa es la señal para iniciar una sesión nueva.
 
 > [!TIP]
 > **La mayoría de los malos resultados son problemas de contexto**
 >
-> Una rama incorrecta, una carpeta equivocada o una ventana de contexto casi llena explican muchas más sorpresas que un mal prompt.
+> Una carpeta equivocada o una ventana de contexto casi llena explican muchas más sorpresas que un mal prompt.
 
 ## Prueba antes de que Git escriba nada
 
@@ -43,10 +46,11 @@ Run a browser-level smoke test for the quiz in the integrated browser. Check key
 2. Si algo falla, deja que el agente lo corrija y vuelva a ejecutar la prueba hasta que todo pase.
 3. Continúa solo cuando la creación del proyecto y las pruebas se hayan completado correctamente.
 
-Todavía no se ha escrito nada en Git. El siguiente paso es `/init`, que lee el proyecto tal como está, así que conviene asegurarte primero de que funciona.
+Todavía no se ha escrito nada en Git. En la siguiente lección ejecutarás `/init create simple rules for the project`, que lee el proyecto tal como está, así que conviene asegurarte primero de que funciona.
 
 ## Resumen y pasos siguientes
 
 Has confirmado en qué trabaja la sesión y comprobado el cuestionario con una prueba de humo en el explorador. Continúa con la [lección 4: Recoger las instrucciones del proyecto][next-lesson].
 
 [next-lesson]: ../4-project-instructions/
+[publish-lesson]: ../5-publish/

docs/es-es/first-steps/copilot-app/4-project-instructions.md

@@ -3,7 +3,7 @@ title: "Lección 4 - Recoger las instrucciones del proyecto"
 description: "Ejecuta /init para generar instrucciones del agente que describan el Space Quiz terminado y adáptalas a tu forma de trabajar."
 authors:
   - jamesmontemagno
-lastUpdated: 2026-09-28
+lastUpdated: 2026-10-05
 ---
 
 Ahora que el cuestionario está creado, perfeccionado y probado, recoge cómo deben tratar este proyecto las sesiones futuras. Cada sesión lee las instrucciones del agente antes de empezar a trabajar, así que te ahorran repetir las mismas directrices en cada prompt.
@@ -16,7 +16,9 @@ En esta lección:
 
 ## Recoge las reglas con `/init`
 
-1. Ejecuta `/init` en la sesión de la aplicación.
+Incluye un prompt después de `/init`. Si envías el comando sin texto adicional, puede aparecer `Command input required`.
+
+1. Ejecuta `/init create simple rules for the project` en la sesión de la aplicación.
 2. Revisa el archivo de instrucciones del agente generado antes de aceptarlo.
 3. Redúcelo a directrices que reflejen este proyecto: un único archivo, sin dependencias, accesible y probado en el explorador.
 

docs/es-es/first-steps/copilot-app/5-publish.md

@@ -3,7 +3,7 @@ title: "Lección 5 - Publicar el proyecto"
 description: "Convierte el experimento local de Space Quiz en un repositorio público de GitHub."
 authors:
   - jamesmontemagno
-lastUpdated: 2026-09-28
+lastUpdated: 2026-10-05
 ---
 
 Publica el Space Quiz para poder gestionar incidencias, utilizar árboles de trabajo aislados y completar un flujo de trabajo de solicitudes de incorporación de cambios.
@@ -23,7 +23,7 @@ Initialize this folder as a Git repository, create an initial commit, and create
 ```
 
 > [!WARNING]
-> El agente pedirá confirmación antes de crear un repositorio o enviar código. Revisa la acción propuesta y el destino antes de aprobarla.
+> Según la configuración de aprobación, el agente puede pedir confirmación antes de crear un repositorio o enviar código, o esas acciones pueden aprobarse automáticamente. Con **Approve all**, no esperes una solicitud de confirmación adicional. Revisa la configuración, la acción solicitada y el destino antes de enviar el prompt de publicación.
 
 Cuando el agente termine:
 

docs/es-es/first-steps/copilot-app/8-review-loop.md

@@ -3,7 +3,7 @@ title: "Lección 8 - Completar el ciclo de revisión de Copilot"
 description: "Crea una solicitud de incorporación de cambios, solicita una revisión de Copilot, atiende los comentarios pertinentes y deja que Agent Merge mantenga la solicitud en buen estado."
 authors:
   - jamesmontemagno
-lastUpdated: 2026-09-28
+lastUpdated: 2026-10-05
 ---
 
 Convierte la incidencia implementada en una solicitud de incorporación de cambios, solicita una revisión de Copilot y atiende los comentarios antes de combinarla.
@@ -18,6 +18,11 @@ En esta lección:
 
 ## Crea y revisa la solicitud de incorporación de cambios
 
+> [!IMPORTANT]
+> Copilot Free no incluye la revisión de código de Copilot para solicitudes de incorporación de cambios. Utiliza Copilot Student o un plan de pago de Copilot que incluya la revisión de código. Una organización también puede habilitar la revisión de código de pago en GitHub.com para miembros sin una licencia de Copilot. Consulta la [disponibilidad de la revisión de código de Copilot][code-review].
+>
+> Si no tienes acceso, completa los pasos 1-4, revisa las diferencias tú mismo o pide a un compañero que las revise y omite los pasos 5-9, que dependen de los comentarios de revisión de Copilot. Atiende los comentarios de los revisores humanos y vuelve a probar la funcionalidad antes de continuar con la sección de combinación.
+
 1. Abre el panel desplegable de la derecha y selecciona la pestaña **Changes** para inspeccionar los archivos modificados en la sesión.
 2. Selecciona **Create PR** en la barra de herramientas de la sesión.
 3. Revisa el título y la descripción generados y crea la solicitud de incorporación de cambios.
@@ -41,4 +46,5 @@ Si prefieres combinarla tú mismo, revisa las diferencias finales, comprueba la
 
 Has completado el ciclo de desarrollo desde la incidencia hasta la solicitud de incorporación de cambios revisada y combinada. Continúa con la [lección 9: Automatizar la clasificación de incidencias][next-lesson].
 
+[code-review]: https://docs.github.com/copilot/concepts/agents/code-review
 [next-lesson]: ../9-automations/

docs/es-es/first-steps/copilot-cli/2-project-instructions.md

@@ -3,7 +3,7 @@ title: "Lección 2 - Recoger las instrucciones del proyecto"
 description: "Ejecuta /init para generar instrucciones del agente que describan el Space Quiz terminado y adáptalas a tu forma de trabajar."
 authors:
   - jamesmontemagno
-lastUpdated: 2026-09-28
+lastUpdated: 2026-10-05
 ---
 
 Con un cuestionario funcional en el disco, genera instrucciones del agente que describan el proyecto real. Cada sesión futura lee estas instrucciones antes de empezar a trabajar, así que te ahorran repetir las mismas directrices en cada prompt.
@@ -16,7 +16,9 @@ En esta lección:
 
 ## Recoge las reglas con `/init`
 
-1. Ejecuta `/init` en la sesión.
+Incluye un prompt después de `/init`. Si envías el comando sin texto adicional, puede aparecer `Command input required`.
+
+1. Ejecuta `/init create simple rules for the project` en la sesión.
 2. Revisa el archivo de instrucciones generado antes de aceptarlo.
 3. Conserva solo las directrices que correspondan a este proyecto: un único archivo, sin dependencias, accesible y probado en el explorador.
 

docs/es-es/first-steps/vscode/0-prerequisites.md

@@ -24,6 +24,9 @@ Necesitas:
 - [Visual Studio Code][vscode].
 - [Git][git] instalado. Ejecuta `git --version` en una terminal para comprobarlo.
 
+> [!IMPORTANT]
+> Copilot Free no incluye la revisión de código de Copilot para solicitudes de incorporación de cambios. La solicitud de revisión de la [lección 8][review-lesson] requiere [acceso a la revisión de código de Copilot][code-review]. Si no tienes acceso, sigue la alternativa de revisión manual de esa lección.
+
 ## Configura VS Code
 
 1. Instala [VS Code][vscode] e inicia sesión en GitHub. Copilot y Copilot Chat están integrados, así que abre la vista **Chat** desde la barra de título y confirma que responde.
@@ -51,4 +54,6 @@ VS Code está listo con Copilot Chat, la extensión de GitHub y una carpeta `spa
 [git]: https://git-scm.com/downloads
 [pr-extension]: https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github
 [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing
+[review-lesson]: ../8-review-and-merge/
+[code-review]: https://docs.github.com/copilot/concepts/agents/code-review
 [next-lesson]: ../1-build-and-polish/

docs/es-es/first-steps/vscode/2-project-instructions.md

@@ -3,7 +3,7 @@ title: "Lección 2 - Recoger las instrucciones del proyecto"
 description: "Ejecuta /init en Copilot Chat para generar .github/copilot-instructions.md para Space Quiz y adáptalo."
 authors:
   - jamesmontemagno
-lastUpdated: 2026-09-28
+lastUpdated: 2026-10-05
 ---
 
 Con un cuestionario funcional en el área de trabajo, genera instrucciones personalizadas del repositorio que describan el proyecto real. Copilot lee estas instrucciones con cada solicitud de chat.
@@ -16,7 +16,7 @@ En esta lección:
 
 ## Recoge las reglas con `/init`
 
-1. Ejecuta `/init` en Copilot Chat.
+1. Ejecuta `/init create simple rules for the project` en Copilot Chat.
 2. Revisa el archivo `.github/copilot-instructions.md` generado antes de guardarlo.
 3. Conserva solo las directrices que correspondan a este proyecto: un único archivo, sin dependencias, accesible y probado en el explorador.
 

docs/es-es/first-steps/vscode/8-review-and-merge.md

@@ -3,7 +3,7 @@ title: "Lección 8 - Revisar y combinar"
 description: "Crea una solicitud de incorporación de cambios desde Source Control, solicita una revisión de código de Copilot, atiende los comentarios con las herramientas de GitHub y combínala."
 authors:
   - jamesmontemagno
-lastUpdated: 2026-09-28
+lastUpdated: 2026-10-05
 ---
 
 Inspecciona, revisa y combina el nuevo trabajo con las herramientas de GitHub en VS Code.
@@ -17,6 +17,11 @@ En esta lección:
 
 ## Inspecciona, revisa y combina
 
+> [!IMPORTANT]
+> Copilot Free no incluye la revisión de código de Copilot para solicitudes de incorporación de cambios. Utiliza Copilot Student o un plan de pago de Copilot que incluya la revisión de código. Una organización también puede habilitar la revisión de código de pago en GitHub.com para miembros sin una licencia de Copilot, pero esto no concede acceso a la revisión de código en los IDE. Consulta la [disponibilidad de la revisión de código de Copilot][code-review].
+>
+> Si no tienes acceso, omite la solicitud de revisión de Copilot del paso 4. Revisa las diferencias tú mismo o pide a un compañero que las revise y continúa con los pasos restantes, atendiendo los comentarios de los revisores humanos y volviendo a probar antes de combinar.
+
 1. Abre **Source Control** para inspeccionar los archivos modificados y las diferencias antes de crear nada.
 2. Crea un commit con el nuevo trabajo utilizando de nuevo el botón **sparkle** para escribir el mensaje.
 3. Selecciona el botón **Create Pull Request** que aparece en **Source Control**. Copilot redacta el título y la descripción a partir de tus commits, así que obtienes una solicitud de incorporación de cambios mejor que si la pides desde cero.
@@ -32,4 +37,5 @@ En esta lección:
 
 Has revisado y combinado una solicitud de incorporación de cambios sin salir de VS Code. Continúa con la [lección 9: Entregar la siguiente idea a una sesión en la nube][next-lesson].
 
+[code-review]: https://docs.github.com/copilot/concepts/agents/code-review
 [next-lesson]: ../9-cloud-session/

docs/first-steps/copilot-app/0-prerequisites.md

@@ -24,6 +24,9 @@ You need:
 - an active Copilot plan. [Activate Copilot Free or a paid Copilot plan][copilot-plans]. If your organization already provides Copilot access, use that account.
 - a computer running macOS, Windows, or Linux.
 
+> [!IMPORTANT]
+> Copilot Free does not include Copilot code review for pull requests. The review request in [Lesson 8][review-lesson] requires [access to Copilot code review][code-review]. If you do not have access, follow that lesson's manual-review alternative.
+
 The app ships with Git, so there is nothing else to install.
 
 > [!NOTE]
@@ -75,4 +78,6 @@ You verified the prerequisites, installed the app, chose a model, and explored i
 [copilot-plans]: https://github.com/features/copilot/plans
 [download-app]: https://gh.io/app
 [active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing
+[review-lesson]: ../8-review-loop/
+[code-review]: https://docs.github.com/copilot/concepts/agents/code-review
 [next-lesson]: ../1-create-workspace/