WordPress / WordPress/Learn

Topic Idea: How to write image alt-text

Open
#1,463 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
PHP
Stars
333
Forks
127
Avg merge
1d 7h
Merged PRs (30d)
11

Description

Details

  • Topic title: How to write image alt-text
  • Topic description: Primarily focus on what creates quality alt text descriptions, but demonstrate how to add these in WordPress. This should be a brief lesson plan and tutorial video solely focused on this, but can be referred to from any other media related content and from the Photos team.
  • Objective: The objective of this lesson is to teach how to write effective alt-text for images and apply it in WordPress for better accessibility. Students will learn to identify key components of good alt-text, write alt-text, and implement it in WordPress.
  • Content type: lesson plan, tutorial
  • WordPress version: current
  • Will you be creating this content?: No

Related Resources

Links to related content on Learn, HelpHub, DevHub, GitHub Gutenberg Issues, DevNotes, etc.

Triage Checklist

Please follow this Vetting content topic ideas handbook page guide.

  • SME assigned
  • Remove Needs Subject Matter Expert label
  • Content Category applied (Ex. PHP, Gutenberg, Block Theme)
  • Topic idea has passed vetting checks
  • Content type label applied
  • Priority set
  • Content Type Checklist applied
  • Content type
  • Audience set
  • Experience Level set
  • Product type (theme, plugin)
  • WordPress Version applied through Milestone (Ex. milestone 5.9)
  • If the Topic Idea reporter has not opted to create the content, apply Needs Content Creator label
  • Ticket moved to Ready to Create

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the proposed objective and the related Slack thread linked in the issue. Confirm the topic through the listed vetting checklist, including SME assignment, content type, audience, experience level, and WordPress version. Done means a vetted brief lesson plan and tutorial video explaining effective alt text and how to add it in WordPress, with a content creator identified.

Written by the indexing model from the issue text.

Assessment

Tech stack
wordpress
Domain
accessibility, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.