Solution Reference: Challenge 13 -- Copilot as Collaborator

This shows an example Copilot interaction and critical evaluation.

Example interaction transcript

Prompt to Copilot:

Review the alt text in docs/welcome.md and suggest improvements for screen reader users.

Copilot response (example):

The image on line 42 has alt="screenshot" which is not descriptive. A better alternative would be: alt="Learning Room repository page showing the Code tab with a list of files including README.md, docs folder, and .github folder".

Before and after

Before:

![screenshot](images/repo-overview.png)

After (improved with Copilot's help):

![Learning Room repository Code tab showing file list with README.md, docs folder, and .github folder](images/repo-overview.png)

Critical evaluation notes

Not everything Copilot suggests is correct. Here is how to evaluate:

What Copilot got right: The suggestion to be more descriptive than "screenshot" is correct. Screen reader users need to understand what the image communicates, not just that it exists.

What I adjusted: Copilot's suggested alt text was 30 words. I shortened it to 18 words while keeping the key information. Alt text should be concise.

What Copilot missed: It did not flag that the image might be decorative (meaning alt="" would be appropriate). I checked -- it is informational, so descriptive alt text is correct.

Alternate approaches

  • Ask Copilot to improve documentation clarity, then evaluate whether the suggestions make sense
  • Ask Copilot to check Markdown formatting, then verify its corrections
  • Ask Copilot to suggest commit messages, then refine them

What matters

The learning objective is using AI as a collaborator while maintaining your own judgment. If you used Copilot, evaluated its output critically, and made an improvement based on that evaluation, you completed this challenge.

Authoritative Sources

Use these official references when you need the current source of truth for facts in this chapter.

Section-Level Source Map

Use this map to verify facts for each major section in this file.