Tooltip formatting issues in WP-CLI Handbook (missing link and extra period)

[rima1889]

Describe the current, buggy behavior

There are tooltip formatting and linking issues in the WP-CLI Handbook documentation pages.

1. On the handbook page, the tooltip for “plugin” does not contain a link when hovering over the word.
2. On some pages, the tooltip text includes an extra period (.) at the end, which looks like a formatting mistake.

These issues affect the readability and consistency of the documentation.

Affected pages:

• ​https://make.wordpress.org/cli/handbook/(​https://make.wordpress.org/cli/handbook/)
• ​https://make.wordpress.org/cli/handbook/guides/installing/(​https://make.wordpress.org/cli/handbook/guides/installing/)
• ​https://make.wordpress.org/cli/handbook/guides/quick-start/(​https://make.wordpress.org/cli/handbook/guides/quick-start/)

Describe how other contributors can replicate this bug

Steps to reproduce:

1. Go to the WP-CLI handbook page: ​https://make.wordpress.org/cli/handbook/(​https://make.wordpress.org/cli/handbook/)
2. Hover over the “plugin” word.
3. Notice that the tooltip appears but no link is attached.

Additional issues:

1. Go to: ​https://make.wordpress.org/cli/handbook/guides/installing/(​https://make.wordpress.org/cli/handbook/guides/installing/)
2. Hover over “php”.
3. The tooltip shows an extra period (.) at the end.

Another example:

1. Go to: ​https://make.wordpress.org/cli/handbook/guides/quick-start/(​https://make.wordpress.org/cli/handbook/guides/quick-start/)
2. Hover over “multisite”.
3. The tooltip text contains an unnecessary extra period (.).

Describe what you would expect as the correct outcome

• The tooltip for “plugin” should contain the correct reference link if it is meant to link to plugin documentation.
• Tooltip text should not include unnecessary extra punctuation, such as an extra period (.).
• Tooltip formatting should remain consistent across the handbook documentation.

Provide a possible solution

• Check the glossary or tooltip configuration used in the WP-CLI handbook.
• Ensure the “plugin” term has the correct link reference attached.
• Remove the extra period (.) from tooltip definitions for terms like php and multisite.

Provide additional context/Screenshots

Screenshots showing the tooltip issues can help illustrate the problem.

​https://ibb.co/7dszNfVL
​https://ibb.co/YB4kS3jC
​https://ibb.co/k6Kp3DsY
​https://ibb.co/vxLpzRDG

[dd32]

Steps to reproduce:

Go to the WP-CLI handbook page: ​https://make.wordpress.org/cli/handbook/(https://make.wordpress.org/cli/handbook/)
Hover over the “plugin” word.
Notice that the tooltip appears but no link is attached.

Glossary entry updated; ​https://make.wordpress.org/wp-admin/post.php?post=2420&action=edit

Hover over “php”.
The tooltip shows an extra period (.) at the end.

Seems intentional by the author, but I agree, a period after a url is not needed here. Updated

Hover over “multisite”.
The tooltip text contains an unnecessary extra period (.).

Updated / modified.

These have some caching in place, changes won't be visible immediately.

[rima1889]

Facing the same tooltip issue

On the WP AI handbook page: ​https://make.wordpress.org/ai/2025/07/17/ai-building-blocks/(​https://make.wordpress.org/ai/2025/07/17/ai-building-blocks/)

• The “plugin” tooltip is inconsistent: some occurrences of the word have a link attached, while others do not.
• “rest api” tooltip contains an extra period (.) at the end.
• “Feature Plugin” tooltip contains an extra period (.) at the end.
• “Slack” tooltip contains an extra period (.) at the end.

These inconsistencies affect readability and documentation accuracy.

Steps to reproduce the issue

1. Go to: ​https://make.wordpress.org/ai/2025/07/17/ai-building-blocks/(​https://make.wordpress.org/ai/2025/07/17/ai-building-blocks/)
2. Hover over “plugin”: notice that some instances have a clickable link, while others do not.
3. Hover over “rest api”, “Feature Plugin”, and “Slack”: notice the extra period (.) at the end of the tooltip text.

Expected behavior

• All occurrences of “plugin” should consistently contain the correct link.
• Tooltip text should not include unnecessary punctuation (extra period).
• Tooltip formatting should be consistent for all terms in the handbook.

Possible solution

• Review the glossary or tooltip configuration for the page.
• Ensure “plugin” has the link attached to every instance.
• Remove the extra period (.) from “rest api”, “Feature Plugin”, and “Slack” tooltip entries.

Additional context / Screenshots

​https://ibb.co/Tq88rWg9
​https://ibb.co/zhhbyP46
​https://ibb.co/wZ9KbDHG
​https://ibb.co/PsdWQQNq
​https://ibb.co/kgk94NbB