Improve accessibility: Add alt text to images and improve heading structure

[BekahHW]

Description

The documentation needs accessibility improvements to ensure it's usable by everyone, including people using screen readers and other assistive technologies.

Accessibility Issues Identified

• Images missing alt text descriptions
• Inconsistent heading hierarchy in some documents
• Poor color contrast in some areas (if applicable)
• Missing semantic structure in some content

Tasks

### Alt Text for Images - COMPLETED
- [x] Audit all images in docs/_assets/images/
- [x] Add descriptive alt text to all images
- [x] Ensure alt text describes the content/function, not just appearance
- [x] Review image captions for clarity

Heading Structure

• Ensure proper heading hierarchy (H1 → H2 → H3, no skipping levels)
• Verify each page has only one H1
• Fix any heading level inconsistencies
• Add heading IDs where missing

Content Structure

• Review list structures for proper nesting
• Ensure tables have proper headers
• Check that links have descriptive text (avoid "click here")

Files to Focus On

- docs/_assets/images/ - All images need alt text

• Files with complex hierarchies like team role descriptions
• Process documents with multiple steps

Acceptance Criteria

- [x] All images have meaningful alt text

• Heading hierarchy is logical and consistent
• Content is screen reader friendly
• Documentation passes basic accessibility checks
• Guidelines created for future content

Resources

• Web Content Accessibility Guidelines (WCAG)
• Alt Text Best Practices

Hi! I'd like to work on this issue. Can I focus on adding alt text to the images for now?

[adiati98]

Hey @abeerios,

Thanks for your interest in taking this issue! ✨

You can work on which one is easier for you first. But we'd like to have all requirements in this issue to be done in one PR.
Let us know if you need help!

[BekahHW]

@abeerios actually, looking at this, I could see how this could be broken into multiple PRs. @adiati98, it's my bad.

If you want to break this into multiple PRs, you can rewrite the issues, link to them in the comments here and tag me so I can review them.

Hello, @BekahHW I wanted to note that I've decided to step back from this issue and won't be making any further changes. Thank you for the opportunity and guidance. I apologize if taking this on has created further confusion.

[BekahHW]

@abeerios I think you're doing a great job on the alt text section. I'm going to go ahead and merge that one in, and reopen the rest as separate issues.

[adiati98]

@BekahHW we might be able to just create sub-issues and refer to this (parent) issue for the descriptions.