Skip to content

Acting on Report Feedback

Getting feedback is only valuable if you know how to use it. This guide helps you prioritize fixes, create an action plan, and turn feedback into long-term learning.

Prioritizing What to Fix

Not all issues are equally important. Here's how to prioritize:

Priority 1: Critical Accessibility Issues

Issues that prevent users from accessing your content.

  • Images with no alt text
  • Form inputs without labels
  • Interactive elements not reachable by keyboard

Priority 2: Potential Bugs

Issues that could cause your code to break or behave unexpectedly.

  • Uncaught errors in async code
  • Variables used before declaration
  • Event listeners that might cause memory leaks

Priority 3: Accessibility Improvements

Issues that make your site harder to use but don't completely block access.

  • Heading hierarchy issues
  • Missing skip links
  • Insufficient focus indicators

Priority 4: Code Quality

Issues that affect maintainability and readability.

  • Duplicate CSS rules
  • Overly specific selectors
  • Unused variables

Priority 5: Enhancements

Nice-to-have improvements.

  • Using modern CSS features
  • Refactoring for cleaner organization
  • Performance optimizations

Creating an Action Plan

After reviewing your reports, create a simple action list:

## Must Fix
- [ ] Add alt text to hero image
- [ ] Add labels to form inputs

## Should Fix
- [ ] Add error handling to fetch calls
- [ ] Fix heading hierarchy (h1 -> h3 skip)

## Nice to Have
- [ ] Consolidate duplicate button styles
- [ ] Add CSS custom properties for colors

When Findings Seem Wrong

Sometimes reports flag issues that are fine in your specific context. This can happen because:

  • The automated tool doesn't understand your use case
  • The code pattern is unusual but intentional
  • The issue is handled elsewhere in a way the tool can't detect

When this happens, consider whether the tool might be right anyway. If a tool is confused, future developers might be too. But if you're confident the code is correct, note it and move on.

Understanding the Strengths Section (Pro)

Pro subscribers see a Strengths section highlighting what you did well:

  • Reinforcement - Knowing what you did well helps you repeat it
  • Confidence - Seeing strengths balances the critique
  • Patterns - Identify which areas come naturally to you

Regenerating Reports

After making improvements, regenerate reports to verify your fixes.

When to regenerate:

  • After fixing critical issues
  • When you've addressed multiple findings
  • Before sharing your solution publicly

What to look for:

  • Are the issues you fixed now gone?
  • Did fixing one issue create others?
  • Are there new issues you hadn't noticed?

Don't Aim for Perfection

The goal isn't a perfect report—it's learning.

Every issue is a lesson. A report full of issues isn't a failure—it's a roadmap for growth.

Know when to move on. Not every issue needs to be fixed. It's okay to note an issue for future reference, disagree with a suggestion if you have good reason, or leave minor issues to focus on new challenges.

Balance learning and building. Spending hours perfecting one solution has diminishing returns. Fix the most educational issues, note patterns to improve, and apply learnings to new work.

Developing Long-Term Habits

Keep a Learning Log

Track recurring feedback across solutions:

## My Common Issues

### Accessibility
- I often forget alt text on images

### CSS
- Tendency to over-nest selectors

### JavaScript
- Need to improve error handling

Set Improvement Goals

## This Month's Focus

1. Always write alt text immediately after adding an image
2. Add error handling to every fetch call

When you notice improvement—fewer accessibility issues, cleaner CSS, more robust JavaScript—acknowledge it. Growth in these skills makes you a better developer.