Add semantic patterns documentation #38778
Conversation
youknowriad
added
[Type] Developer Documentation
youknowriad
requested review from
ajitbohra,
mkaz and
ryanwelcher
as code owners
There was a problem hiding this comment.
Looks great! It needs to be better advertised . There is also something with attributes where you can mark their role as content in case you want to inject that into the pattern. @ntsekouras might know better if that applies here.
|
Good call @gziolo Yeah, the role is indeed related. It's still experimental though, so let's wait a bit before adding that information. |
| 'categories' => array( 'header' ), | ||
| // Assigning the pattern the "header" area. | ||
| 'blockTypes' => array( 'core/template-part/header' ), |
There was a problem hiding this comment.
It's worth noting that core/template-part/header is something that is used only by template parts and is not a generic API for block variations. It had been discussed to support block variations with the same format, but eventually left for template parts to override the filtering patterns function with that naming convention.
|
I created a follow up for this one here: #38809, if you think it brings some value 😄 |
related #28737
While I try to work on #28737 I noticed that we actually already support these kind of semantic patterns but that it was not documented properly.
It was not easy to come with the right wording here. So please happy to take on suggestions.