Documentation-Issue-Tracker icon indicating copy to clipboard operation
Documentation-Issue-Tracker copied to clipboard

The Template Hierarchy graph in your official documentation is not updated

Open devis4wd opened this issue 8 months ago • 1 comments

Issue Description

The official Template Hierarchy graph is not updated since obviously templates named as single-$posttype-$slug.php are NOT recognized by WP 6.7.

This mistake cost me several hours of useless debugging cause i trusted your official documentation. Please could you update the documentation before this drives many developers crazy for no real reason?

Thank you very much,

Devis

URL of the Page with the Issue

https://developer.wordpress.org/themes/templates/template-hierarchy/ https://i0.wp.com/developer.wordpress.org/files/2023/10/template-hierarchy-scaled.jpeg?ssl=1 https://developer.wordpress.org/themes/basics/template-hierarchy/

Section of Page with the issue

Visual Overview

Why is this a problem?

Developers will rely on your official graph to know the right names for their custom theme templates files. Since the documentation is wrong, they'll spend a lot of time on figuring out why things are not working properly. If we can't rely on official documentation, then I don't know what we can rely on.

Suggested Fix

Please update the graph image as soon as possible

Image Image Image

devis4wd avatar Mar 22 '25 09:03 devis4wd

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

github-actions[bot] avatar Mar 22 '25 09:03 github-actions[bot]

So what about this ticket?

devis4wd avatar Sep 11 '25 08:09 devis4wd