Update image (#22)

* make updates to activity directions in the prompts * Enhance documentation for coding agent usage Added instructions for monitoring coding agent progress and checking open pull requests. * Change image for pull request creation instructions Updated image source for pull request creation step. * Replace images in 1-step.md with updated sources Updated images in the step-by-step guide for clarity. * Replace issue draft and created issue screenshots Updated screenshots for issue draft and created issue sections. * Adjust image sizes and alt text in 3-step.md Updated image sizes and alt text in the documentation for clarity and consistency.

Author: arilivigni

.github/steps/1-step.md

@@ -91,8 +91,8 @@ Add a description:
 1. Verify the repository appears in your sources list
 
  <img width="30%" height="30%" alt="Add sources" src="https://github.com/user-attachments/assets/05268c3f-5270-4e60-bc87-69fc27b1df72" />
- <img width="30%" height="30%" alt="Add sources repository" src="https://github.com/user-attachments/assets/d8b38b95-98ca-44a3-b7b4-d1ab4c12d348" />
- <img width="30%" height="30%" alt="Add sources repository files" src="https://github.com/user-attachments/assets/8340a69c-0d05-49df-92e7-bf929b57443b" />
+ <img width="30%" height="30%" alt="Add sources repository" src="https://github.com/user-attachments/assets/83725fcc-eb0d-4478-ba88-8de0cd8a6732" />
+ <img width="30%" height="30%" alt="Add sources repository files" src="https://github.com/user-attachments/assets/f3e9c65a-1446-4f1f-a84f-10f893d0e22e" />
 
 ### ⌨️ Activity: Create an issue in the repository for a README for OctoAcme Project Management Docs
 
@@ -106,22 +106,25 @@ Add a description:
  > that has links to all the docs in the docs folder.
  > - The README should also contain a brief summary of the project management processes used by OctoAcme.
  > - Make sure README, project management processes summary, and links are in the title of the issue.
+ > - Use the "Add Content to Project Management Process Docs" template.
+ > - Which process document do you want to update? "<new document>"
+ > - Fill in the other fields
  > ```
 
 You can then add this issue to your repository by clicking the **Create** button.
 
 <details>
 <summary> 📷 Show screenshot of the issue draft</summary>
 
-<img width="50%" height="50%" alt="conversation to create an issue" src="https://github.com/user-attachments/assets/cc152bc6-d189-4143-8eea-719f70e43a6f" />
+<img width="50%" height="50%" alt="README issue drafted" src="https://github.com/user-attachments/assets/fd324605-a02b-4d4a-a87f-06db9339bb44" />
 
 </details>
 You can copy or open the link in a new tab to see the newly created issue
 
 <details>
 <summary> 📷 Show screenshot of the created issue</summary>
 
-<img width="50%" height="50%" alt="cs-9" src="https://github.com/user-attachments/assets/a174f9cc-6c28-4698-a9b0-9e61e711413a" />
+<img width="50%" height="50%" alt="README issue created" src="https://github.com/user-attachments/assets/c4be58b8-edbf-463a-be49-8ad184d59617" />
 
 </details>
 

.github/steps/2-step.md

@@ -68,8 +68,8 @@ In this activity, you will connect the issue you created in Step 1 to your Copil
 
 1. **Create the pull request**: Now send this prompt to create the pull request:
 
- <img width="80%" height="80%" alt="repository issue and pull request creation" src="https://github.com/user-attachments/assets/aab825e3-53bb-40e7-adbd-efbae520293d" />
-
+ <img width="80%" height="80%" alt="repository issue and pull request creation" src="https://github.com/user-attachments/assets/af469c6a-fc87-454b-9a65-23ffe0d7cd50" />
+ 
  > ![Static Badge](https://img.shields.io/badge/-Prompt-text?style=social&logo=github%20copilot)
  >
  > ```prompt
@@ -78,16 +78,34 @@ In this activity, you will connect the issue you created in Step 1 to your Copil
  > used by OctoAcme based on the summary we just created.
  > - The README should be in the `docs/` folder
  > - Add this pull request to the attached issue.
- > - Add {{login}} as a reviewer
+ > - Add {{login}} as a reviewer for the pull request
  > ```
 
 1. **Allow the coding agent**: When prompted, select **Allow** to let the coding agent work on your repository
 
  <img width="50%" height="50%" alt="Copilot coding agent allow" src="https://github.com/user-attachments/assets/b0c92c04-d12b-4c5e-b682-33643b90ee11" />
 
-1. **Monitor progress**: You should receive a notification that the Copilot coding agent is working on your pull request. Go to your repository and click **Pull requests** to see the progress:
+1. **Monitor progress**: You should receive a notification that the Copilot coding agent is working on your pull request. 
+
+ There are two ways you can check the status of the coding agent working on your pull request
+ 
+ 1. Go to your repository and click **Pull requests** to see the progressor:
+ 
+ <img width="70%" height="70%" alt="pull requests" src="https://github.com/user-attachments/assets/88e9876e-2dae-43a4-86ff-29c4cdc6077c" />
+ 
+ 1. You can track progress and view details in **Mission Control** for **agent tasks** by following the task link
+ 
+ <img width="40%" height="40%" alt="mission control" src="https://github.com/user-attachments/assets/a64c1826-720e-4b5f-8d0f-8aebc9aca501" />
+
+1. **Check open pull requests**: We can check pull request status from our **Copilot Space** as well.
+
+ > ![Static Badge](https://img.shields.io/badge/-Prompt-text?style=social&logo=github%20copilot)
+ >
+ > ```prompt
+ > check open pull requests
+ > ```
 
- <img width="70%" height="70%" alt="pull requests" src="https://github.com/user-attachments/assets/d30685c3-046b-4c6e-8254-4bcb8aa959b5" />
+ <img width="40%" height="40%" alt="mission control" src="https://github.com/user-attachments/assets/ef0ffd8a-ba8f-4618-a2cc-8e1e0d1bb309" />
 
  > [!NOTE] 
  > The coding agent typically takes 5-15 minutes to complete the work. You can click **View session** to watch the progress if desired.

.github/steps/3-step.md

@@ -34,13 +34,10 @@ _Use the following prompt in a new Copilot Space conversation:_
 - Select the issue template to this new Copilot Space conversation. </br>
  `.github/ISSUE_TEMPLATE/add-update-content-to-process-docs.yml`
 
- <img width="50%" height="50%" alt="Attach" src="https://github.com/user-attachments/assets/2a447ff9-76d7-462f-9292-4663c8dc0fc9" />
-
+ <img width="30%" height="30%" alt="Attach" src="https://github.com/user-attachments/assets/2a447ff9-76d7-462f-9292-4663c8dc0fc9" />
  <img width="30%" height="30%" alt="Attach files" src="https://github.com/user-attachments/assets/6ac6e33d-b333-424f-b431-e3feb7022b841" />
 
- <img width="50%" height="50%" alt="Attach issue template" src="https://github.com/user-attachments/assets/c02537ad-173e-430d-9e24-6a95763b8f30" />
-
- <img width="60%" height="60%" alt="Attach issue template conversation" src="https://github.com/user-attachments/assets/9a1a06b1-60fe-4794-a2a9-69d09aeab47f" />
+ <img width="30%" height="30%" alt="Attach issue template conversation" src="https://github.com/user-attachments/assets/5fc71905-ede6-45cb-bcfa-93d2797160b2" />
 
  > ![Static Badge](https://img.shields.io/badge/-Prompt-text?style=social&logo=github%20copilot)
  >
@@ -54,10 +51,11 @@ _Use the following prompt in a new Copilot Space conversation:_
  > - The issue should detail why this is important, potential personas to add, and how it will improve project outcomes.
  > - add to the process document `docs/octoacme-roles-and-personas.md`
  > ```
- >
- > <img width="50%" height="50%" alt="personas/roles issue draft" src="https://github.com/user-attachments/assets/d3700d45-a16a-482a-b2e0-5310f80162b6" />
 
-<img width="50%" height="50%" alt="personas/roles issue created" src="https://github.com/user-attachments/assets/c6e3f128-6254-4f0c-a1a6-f31b9d8b56b2" />
+ <img width="50%" height="50%" alt="personas/roles issue draft" src="https://github.com/user-attachments/assets/cd02e396-2505-450a-aca3-8e1642d6306a" />
+
+ <img width="50%" height="50%" alt="personas/roles issue created" src="https://github.com/user-attachments/assets/7f30e13b-7efd-45a0-939a-e7095ff0637c" />
+
 
 ### ⌨️ Activity: Attach an issue and create a Pull Request
 
@@ -80,7 +78,7 @@ Check issues list: [https://github.com/{{full_repo_name}}/issues](https://github
 > @{{full_repo_name}}/issues/4
 > ```
 
- <img width="50%" height="50%" alt="repository issue and pull request creation" src="https://github.com/user-attachments/assets/31955ab4-04f4-4316-811e-0c7234f02567" />
+ <img width="40%" height="40%" alt="repository issue and pull request creation" src="https://github.com/user-attachments/assets/cf4f0c32-76cb-429d-b607-f65f444b07d5" />
 
 > ![Static Badge](https://img.shields.io/badge/-Prompt-text?style=social&logo=github%20copilot)
 >
@@ -91,32 +89,50 @@ Check issues list: [https://github.com/{{full_repo_name}}/issues](https://github
 > - The pull request should include updates to existing docs or new templates/checklists as needed.
 > - All documents should be in the `docs/` folder
 > - Add this pull request to the attached issue.
-> - Add {{login}} as a reviewer
+> - Add {{login}} as a reviewer for this pull request
 > ```
 
-Select **Allow**
+1. **Allow the coding agent**: When prompted, select **Allow** to let the coding agent work on your repository
 
  <img width="50%" height="50%" alt="Copilot coding agent allow" src="https://github.com/user-attachments/assets/b0c92c04-d12b-4c5e-b682-33643b90ee11" />
 
-You should have gotten a notification that Copilot coding agent is working on your pull request.
+1. **Monitor progress**: You should receive a notification that the Copilot coding agent is working on your pull request. 
+
+ There are two ways you can check the status of the coding agent working on your pull request
+ 
+ 1. Go to your repository and click **Pull requests** to see the progressor:
+ 
+ <img width="70%" height="70%" alt="pull requests" src="https://github.com/user-attachments/assets/88e9876e-2dae-43a4-86ff-29c4cdc6077c" />
+ 
+ 1. You can track progress and view details in **Mission Control** for **agent tasks** by following the task link
+ 
+ <img width="40%" height="40%" alt="mission control" src="https://github.com/user-attachments/assets/a64c1826-720e-4b5f-8d0f-8aebc9aca501" />
+
+1. **Check open pull requests**: We can check pull request status from our **Copilot Space** as well.
+
+ > ![Static Badge](https://img.shields.io/badge/-Prompt-text?style=social&logo=github%20copilot)
+ >
+ > ```prompt
+ > check open pull requests
+ > ```
+
+ <img width="40%" height="40%" alt="mission control" src="https://github.com/user-attachments/assets/66693282-e5f6-45d6-8ca8-968e73826738" />
 
-Go to your repository and click **Pull requests** and you should see something similar to the following:
+ > [!NOTE] 
+ > The coding agent typically takes 5-15 minutes to complete the work. You can click **View session** to watch the progress if desired.
 
- <img width="70%" height="70%" alt="pull requests" src="https://github.com/user-attachments/assets/d30685c3-046b-4c6e-8254-4bcb8aa959b5" />
+1. **Review and merge**: Once the pull request is ready:
 
-- It takes approximately 5 to 15 minutes for the coding agent to work on the issue.
-- If you would like to see how the Copilot coding agent is progressing you can click the **View session** button and interact in the session.
-- Once you are satisfied with the content **Submit review**, leave a comment (optional), click **Approve**, then **Submit review**
+ a. **Submit review**: Leave a comment (optional), click **Approve**, then **Submit review**
 
- <img width="70%" height="70%" alt="Add review" src="https://github.com/user-attachments/assets/ea460dc3-a86d-467b-8469-bd9244b915ea" />
+  <img width="70%" height="70%" alt="Add review" src="https://github.com/user-attachments/assets/ea460dc3-a86d-467b-8469-bd9244b915ea" />
 
- <img width="50%" height="50%" alt="Submit review" src="https://github.com/user-attachments/assets/15042891-c8fa-4acc-a25d-c588cf6a3ffe" />
- </br>
+ <img width="50%" height="50%" alt="Submit review" src="https://github.com/user-attachments/assets/15042891-c8fa-4acc-a25d-c588cf6a3ffe" />
 
-- At the bottom select **Ready for review** and then **Merge pull request** and **Confirm merge**
+ b. **Merge**: Select **Ready for review**, then **Merge pull request** and **Confirm merge**
 
- <img width="50%" height="50%" alt="Ready for review" src="https://github.com/user-attachments/assets/2348378d-a597-404f-827d-4003d79055c0" />
- <img width="50%" height="50%" alt="Merge pull request" src="https://github.com/user-attachments/assets/fda15799-a123-4e6a-b32a-c7ec44db3418" />
+  <img width="50%" height="50%" alt="Ready for review" src="https://github.com/user-attachments/assets/2348378d-a597-404f-827d-4003d79055c0" />
+  <img width="50%" height="50%" alt="Merge pull request" src="https://github.com/user-attachments/assets/fda15799-a123-4e6a-b32a-c7ec44db3418" />
 
 <details>
 <summary>Having trouble? 🤷</summary>