WordPress / WordPress/Learn

On course pages, consider changing "Preview" to a less ambiguous word

Open
#2,829 6 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

[Component] Learn Theme [Type] Enhancement
Dominant language
PHP
Stars
333
Forks
127
Avg merge
1d 7h
Merged PRs (30d)
11

Description

Description

A user during an Online Workshop pointed out that the word "Preview" – visible on certain lessons – could be interpreted to mean that you would only get a small portion of the lesson without registering for the course. In fact, when a lesson is set to be previewable by its author, a learner is able to see the entire lesson without needing to register for the whole course.

Step-by-step reproduction instructions

The "Preview" button is visible on any course page with at least one lesson that's been set as "previewable" – such as: Intermediate Theme Developer:
https://learn.wordpress.org/course/intermediate-theme-developer/

Intermediate_Theme_Developer___Learn_WordPress

Screenshot

Intermediate_Theme_Developer___Learn_WordPress

Solution

Is there another word or phrase we can use instead?

The workshop participant suggested "View lesson" but I wonder if that might not distinguish previewable lessons enough from lessons that aren't set to be previewable. Other ideas:

  • Sample lesson
  • Preview full lesson
  • Sample lesson without login (but this is very long)

@jonathanbossenger @westnz Any other ideas come to mind?

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 at the Intermediate Theme Developer course page and inspect the Preview button shown for previewable lessons. Review the existing label and the suggested alternatives, then confirm the chosen wording clearly communicates that the entire lesson is available; the issue does not name a source file or test.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
frontend
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.