Skip to content

Audit: fix missing hero images, add Contact business info, improve FAQ accessibility#10

Draft
phoward38 wants to merge 1 commit into
mainfrom
codex/conduct-codebase-review-and-audit
Draft

Audit: fix missing hero images, add Contact business info, improve FAQ accessibility#10
phoward38 wants to merge 1 commit into
mainfrom
codex/conduct-codebase-review-and-audit

Conversation

@phoward38

Copy link
Copy Markdown
Member

Motivation

  • Resolve build-time missing-asset warnings and improve visual consistency by ensuring hero images reference existing assets.
  • Make the Contact page more informative for visitors by adding explicit business information.
  • Improve FAQ accessibility and clarity by exposing accordion state to assistive technologies and aligning messaging with actual contact behavior.

Description

  • Updated hero image references in src/pages/contact.astro, src/pages/team.astro, src/pages/testimonials.astro, and src/pages/faq.astro to use existing images under /images/heroes/ to eliminate missing-asset warnings.
  • Added a structured "Business Information" block to src/pages/contact.astro (email, location, typical response time) and accompanying styles for clear presentation.
  • Reworded the FAQ availability wording in src/pages/faq.astro to reflect real response expectations and added aria-expanded="false" to accordion buttons.
  • Synchronized aria-expanded in the FAQ accordion toggle code so the UI state and ARIA attribute update together, and added a new audit report at docs/audit-2026-05-23.md documenting findings and recommendations.

Testing

  • Ran npm run build before changes and observed Vite warnings about unresolved hero image references.
  • Ran npm run build after changes and verified the build completes successfully with no missing-asset warnings.
  • Verified static route generation completed (site pages built) during the post-fix build.

Codex Task

@amazon-q-developer amazon-q-developer Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR successfully addresses the stated goals of fixing build warnings and improving accessibility. The changes are well-documented and the implementation correctly resolves missing hero image references, adds business contact information, improves FAQ content consistency, and enhances accessibility with proper ARIA attributes.

Key improvements:

  • Eliminated build-time Vite warnings by updating hero image paths to existing assets
  • Enhanced accessibility with aria-expanded attributes and synchronized state management in FAQ accordion
  • Improved user experience by adding structured business information on the contact page
  • Aligned FAQ content with actual contact behavior

The one indentation issue identified should be corrected to maintain code quality standards.


You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.

Comment thread src/pages/contact.astro
<li><strong>Response time:</strong> Usually within 1 business day</li>
</ul>
</div>
<form class="contact-form">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fix inconsistent indentation - this form element has 12 spaces of leading whitespace while surrounding elements use 6 spaces, breaking the consistent indentation pattern.

Suggested change
<form class="contact-form">
<form class="contact-form">

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request implements several fixes and improvements based on a codebase audit. Key changes include updating missing hero image references across multiple pages (contact, FAQ, team, and testimonials), adding a business information block to the contact page, and improving the accessibility of the FAQ accordion by managing aria-expanded states. Feedback was provided to further improve accessibility on the contact page by replacing a generic div with a semantic <section> element and correcting some minor form indentation.

Comment thread src/pages/contact.astro
Comment on lines +29 to +37
<div class="contact-details" aria-label="Business contact information">
<h2>Business Information</h2>
<ul>
<li><strong>Email:</strong> <a href="mailto:info@noclocks.dev">info@noclocks.dev</a></li>
<li><strong>Location:</strong> Atlanta, Georgia, United States</li>
<li><strong>Response time:</strong> Usually within 1 business day</li>
</ul>
</div>
<form class="contact-form">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Using a generic div with an aria-label is not fully accessible because many screen readers do not announce labels on non-semantic elements unless they have an explicit landmark or widget role. Additionally, the <form> tag on line 37 has incorrect indentation (12 spaces instead of 6).

To improve accessibility and code formatting, we can refactor the div to a semantic <section> element with aria-labelledby pointing to the heading, and fix the indentation of the <form> tag.

      <section class="contact-details" aria-labelledby="contact-details-title">
        <h2 id="contact-details-title">Business Information</h2>
        <ul>
          <li><strong>Email:</strong> <a href="mailto:info@noclocks.dev">info@noclocks.dev</a></li>
          <li><strong>Location:</strong> Atlanta, Georgia, United States</li>
          <li><strong>Response time:</strong> Usually within 1 business day</li>
        </ul>
      </section>
      <form class="contact-form">

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant