WordPress / WordPress/wordpress.org

Forums: Confusion on documentation pages should be solved

Open
#303 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
PHP
Stars
163
Forks
221
PR merge metrics
No merged PRs in 30d

Description

While English documentation has a separate wordpress instance under /documentation, other languages has articles under /support/article and this is causing inconsistency.

  1. The navbar on the second row has the title "Forum" even on documentation pages. It should be "Documentation" for such pages, or revert to the previous "Support" which works fine on both forum and article pages.
  2. The search box placed above the article cannot search articles but shows results from forums. Previous design had search box inside the navbar so there was no confusion but we would expect that the search box is for searching articles when it is placed here.
  3. (This is more a suggestion) Can we add categories in the breadcrumb like those in English documentation?
Pasted_Image_2024_05_03__21_36

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

Compare the English /documentation pages with localized /support/article pages, focusing first on the second-row navbar and the search box above articles. Verify whether the breadcrumb categories are also in scope; done means documentation pages have an unambiguous label, article search returns articles rather than forum results, and the agreed breadcrumb behavior is consistent.

Written by the indexing model from the issue text.

Assessment

Tech stack
php, wordpress
Domain
documentation, search, web-dev
Issue type
Bug
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.