WordPress / WordPress/Learn

Feedback - Content Improvement Feedback

Open
#3,363 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

Content Feedback

Type of feedback

Description

A lot of the content in the course doesn't explain a lot and is more a case of here's functions. For example, you have a section on internationalisation but haven't explained how to set up the translation files, and I don't think it's even mentioned apart from saying WordPress already has files set up. Another example is for things such as callback functions, where you say it can accept an argument, but it is not documented at all in the documentation, and it is not explained how we are supposed to know about them or what objects they are etc. Just a lot of things in general could be explained more clearly and taught about things as a whole, and how to find the solutions to things, and the documentation for things can be scarce

Step-by-step reproduction instructions (optional)

Screenshots or screen recording (optional)

Other information (optional)

https://learn.wordpress.org/lesson/the-commonly-used-internationalization-functions/
Sent via: https://learn.wordpress.org/report-content-feedback/

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 by reviewing the linked internationalization lesson and the broader course content described in the feedback. Identify specific missing explanations, including translation-file setup and callback arguments or objects; done means the affected lessons clearly teach these concepts and how learners can find the relevant documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
content, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.