Problem/Motivation

During usability studies, we observed a conceptual problem caused the names of the menu regions. Some users thought that the 'primary menu' region was the primary menu block. They tried clicking on it to drag it around.

Also, naming a region after the content within the region is not best practice for themes. You can add any content to the primary menu region, and then this name becomes even more confusing.

Proposed resolution

Figure out better names for the regions that describe their position/role on the page, rather than the content inside of them. Then change core default settings as well as the Bartik and Classy themes to implement the new names.

Remaining tasks

Discuss a better name for the menu regions
Patch

User interface changes

Different labels on the block layout page

Final choice is:
header_first: 'Header first'
header_second: 'Header second'
header_third: 'Header third'

API changes

Any sites using these regions will break

Data model changes

Yes, all placed blocks need to be checked.

Beta phase evaluation

Reference: https://www.drupal.org/core/beta-changes
Issue category Task because it is refactoring CSS and templates in Bartik
Issue priority Not critical because Bartik functions fine we are just doing cleanup tasks
Unfrozen changes Unfrozen because it only changes CSS and markup
Prioritized changes The main goal of this issue is usability of the Bartik's codebase
Disruption Disruptive as it will impact custom themes on site update
CommentFileSizeAuthor
#182 2513526-menu-regions-182.patch43.4 KBdcrocks
#182 interdiff-2513526-177-182.txt6.03 KBdcrocks
#177 interdiff-2513526-161-177.txt6.55 KBdcrocks
#177 2513526-menu-regions-177.patch39.18 KBdcrocks
#175 rename_the_menu_regions-2513526-175-reroll.patch37.97 KBjoelpittet
#161 2513526-menu-regions-161.patch37.19 KBdcrocks
#161 interdiff-2513526-156-161.txt2.73 KBdcrocks
#161 after minimal stark.jpg37.22 KBdcrocks
#161 before minimal stark.jpg31.81 KBdcrocks
#161 after classy.jpg33.65 KBdcrocks
#161 before classy.jpg35.13 KBdcrocks
#161 after bartik.jpg59.13 KBdcrocks
#161 before bartik.jpg61.63 KBdcrocks
#155 interdiff-2513526-153-156.txt503 bytesdcrocks
#155 2513526-menu-regions-156.patch36.62 KBdcrocks
#153 2513526-menu-regions-153.patch36.62 KBdcrocks
#153 interdiff-2513526-151-153.txt572 bytesdcrocks
#151 interdiff-2513526-138-151.txt1.18 KBdcrocks
#151 2513526-menu-regions-151.patch36.62 KBdcrocks
#138 2513526-menu-regions-138.patch36.62 KBdcrocks
#138 interdiff-2513526-133-138.txt1 KBdcrocks
#133 2513526-menu-regions-133.patch36.62 KBdcrocks
#133 interdiff-2513526-130-133.txt838 bytesdcrocks
#130 regionchg3.jpg44.91 KBdcrocks
#130 regionchg2.jpg144.42 KBdcrocks
#130 regionchg1.jpg62.57 KBdcrocks
#130 interdiff-2513526-128-130.txt15.42 KBdcrocks
#130 2513526-menu-regions-130.patch36.23 KBdcrocks
#128 interdiff.txt949 bytestim.plunkett
#128 2513526-menu-regions-128.patch29.67 KBtim.plunkett
#127 interdiff-2513526-122-127.txt739 bytesdcrocks
#127 2513526-menu-regions-127.patch29.65 KBdcrocks
#121 interdiff-2513526-120-122.txt312 bytesdcrocks
#121 2513526-menu-regions-122.patch29.58 KBdcrocks
#120 interdiff-2513526-117-120.txt1.28 KBdcrocks
#120 2513526-menu-regions-120.patch29.46 KBdcrocks
#117 interdiff-2513526-114-117.txt698 bytesdcrocks
#117 2513526_menu-regions-117.patch29.52 KBdcrocks
#115 2513526_menu-regions-114.patch29.54 KBdcrocks
#112 interdiff-2513526-107-112.txt1.89 KBdcrocks
#112 2513526_menu-regions-112.patch29.55 KBdcrocks
#109 2513526_menu-regions-109.patch28.67 KBdcrocks
#107 interdiff-2513526-100-107.txt1020 bytesdcrocks
#107 2513526_menu-regions-107.patch28.67 KBdcrocks
#100 2513526-menu-regions-100-no-block-rebuild.patch30.4 KBlongwave
#100 2513526-menu-regions-100-rebased.patch28.97 KBlongwave
#95 2513526-menu-regions-95-no-block-rebuild.patch28.9 KBlongwave
#95 2513526-menu-regions-95-rebased.patch27.46 KBlongwave
#86 2513526-86_Rename_the_menu_regions.patch29.09 KBdcrocks
#80 2513526-menu-regions-69-80-interdiff.txt5.38 KBlongwave
#80 2513526-menu-regions-80.patch29.09 KBlongwave
#69 interdiff.txt1.93 KBlauriii
#69 rename_the_menu_regions-2513526-68.patch27.53 KBlauriii
#67 rename_the_menu_regions-2513526-67.patch0 byteslauriii
#61 interdiff.txt702 byteslauriii
#61 rename_the_menu_regions-2513526-61.patch26.44 KBlauriii
#56 Screen Shot 2015-07-23 at 15.38.33.png52.8 KBemma.maria
#56 Screen Shot 2015-07-23 at 15.35.49.png48.56 KBemma.maria
#52 blocklayout.jpg149.97 KBdcrocks
#52 2513526-52_Rename_the_menu_regions_in_Bartik.patch26.43 KBdcrocks
#48 2513526-48_Rename_the_menu_regions_in_Bartik.patch25.97 KBdcrocks
#46 2513526-46_Rename_the_menu_regions_in_Bartik.patch24.8 KBdcrocks
#44 2513526-44_Rename_the_menu_regions_in_Bartik.patch561 bytesmanjit.singh
#36 Block-layout.png265.03 KBmanjit.singh
#33 block.jpg78.26 KBdcrocks
#33 2513526-33_Rename_the_menu_regions_in_Bartik.patch549 bytesdcrocks
#22 2513526-22_Rename_the_menu_regions_in_Bartik.patch494 bytesdcrocks
#20 2513526-10_Rename_the_menu_regions_in_Bartik.patch9.06 KBprajaankit
#18 block1.jpg77.27 KBdcrocks
#9 blockpage2.png121.98 KBdcrocks
#9 2513526-9_Rename_the_menu_regions_in_Bartik.patch13.4 KBdcrocks
#6 blockpage.png119.55 KBdcrocks
#6 2513526-6_Rename_the_menu_regions_in_Bartik.patch13.39 KBdcrocks
#3 2513526-3_Rename_the_menu_regions_in_Bartik.patch20.16 KBdcrocks

Comments

lewisnyman’s picture

lauriii’s picture

dcrocks’s picture

Status: Active » Needs review
StatusFileSize
new20.16 KB

I took a shot at this. I followed previous patterns here by renaming the regions to header_first, _second, and _third, though my prefernce would have been to rename them to header_top, _main, _bottom. But judging from previous discussions, that might not be neutral enough.

Status: Needs review » Needs work

The last submitted patch, 3: 2513526-3_Rename_the_menu_regions_in_Bartik.patch, failed testing.

dcrocks’s picture

The failing tests assume the region 'header' is defined. As far as I know, the tests use Stark which has no region definitions, but pick up the default region definitions from ThemeHandler.php. There are several possible solutions:
Change Themehandler to continue to specify 'header' as a default region. But this means bartik will have a region of 'header' as well as 'header_second', since it inherits from ThemeHandler.php.
Change all the tests to specify 'header-second', but this makes the tests bartik centric.
Leave region 'header' as is, but change the menu regions to 'header_top' and 'header_bottom'.
Use 'header_main' instead of 'header_second' and change all the tests.

A question I have is why does the system page.html twig even have the menu blocks specified and ThemeHandler's default regions have the menu regions, when this really a theme specific thing? Shouldn't core themes specify their own required regions for the blocks they expect to display? It seems some assumptions about core themes are built into the System files and ThemeHandler.php without any backward documentation in core themes.

I know these are "system" menus, but they are theme objects and should be only defined there. My 2 cents, and will fix as recommended or pick my own favorite if no quick response.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new13.39 KB
new119.55 KB

I decided to leave 'header' as is and renamed the regions to header_top, _bottom. I think some of the conceptual problems mentioned have more to do with the block ui than region names. I never understand why drupal didn't have a region structure ui instead of a block ui. Regions are the container, after all.

lewisnyman’s picture

Related: #2005546: Use branding block in place of page template branding variables (site name, slogan, site logo)

I think I prefer first/second/third. Only because top/middle/bottom implies a stacked design, which we shouldn't do.

dcrocks’s picture

Status: Needs review » Needs work

Ok, I'll redo it but still leave 'header' defined in ThemeHandler.php as it seems to want to mimic the semantic elements, but not in Bartik. That also means the block tests won't have to be modified. 'Header_second' might be a good target region for #2005546: Use branding block in place of page template branding variables (site name, slogan, site logo).

dcrocks’s picture

StatusFileSize
new13.4 KB
new121.98 KB

Since there many, many references to region 'header' in #2005546: Use branding block in place of page template branding variables (site name, slogan, site logo) I redid this with regions header, header_first, and header_second. There are patch conflicts with latest #2005546: Use branding block in place of page template branding variables (site name, slogan, site logo) so which ever one goes in 2nd will need a reroll.

dcrocks’s picture

Status: Needs work » Needs review

Doh

MattA’s picture

Personally I think that using "Header" and "Header first" will be ambiguous for users since they won't know which is meant to be the primary region from select boxes. Perhaps rename to "header", "navigation top", "navigation bottom"?

dcrocks’s picture

As per the issue summary, the region names chosen seemed to cause confusion as people seemed to think they could move the region around when all you can do is move blocks. This is a problem with the block ui, which has many issues against it. And there has been a trend in drupal core themes to make region names semantically relevant but don't provide functional or layout definition.

In drupal the primary and secondary menus are special menus with a special 'use' case that a great many people are aware of and look for. They are a carry over from previous drupal versions and the names serve as a mnemonic for those who look for them and the justification of the original region name. That is why I didn't change any of the file names, just the internal labels. We still have primary-/secondary-/menu.css. Maybe one day, support for that use case will go away or be generalized.

Maybe header_sidebar1, -2 would be more acceptable and in keeping with core theme design.

MattA’s picture

Status: Needs review » Needs work

Hmm, thought about it a bit more, and really don't think header first/second is the best option for a couple reasons.

  1. Using numbers also implies a common layout between regions, like a row or column, and reading the label also allows you to know where it is. For example, the labels featured bottom first/second/third and footer first/second/third/fourth, imply that they are all lined up. This is not true for header first, header second or footer fifth.
  2. Also consider scenarios such as deciding where to place a new block. Header first and header second, won't give any context. For example, even with existing site builders, they know one menu/block is for site navigation and the other is for account links, and where they should be placed on the layout. When attempting to place the site navigation block though, the header first and header second labels aren't helpful as they don't relate to the layout in any meaningful way.
bill richardson’s picture

You could just move both menus into header and use css to place them correctly.

dcrocks’s picture

I don't think the right issue is defined here. As far as the conceptual issues with the block ui I don't think changing the design of a specific theme really addresses that problem. If instead, bartik's current design doesn't reflect best practices, then that is something else.

davidhernandez’s picture

+++ b/core/themes/bartik/templates/page.html.twig
@@ -48,10 +48,10 @@
+ * - page.header_first: Region for items like the user account menu.
  * - page.header: Items for the header region.
+ * - page.header_second: Region for items like the main menu.

This does seem confusing. Ordinal naming is fine, but it doesn't make sense when keeping one region just called "header", with first before it and second after it.

joelpittet’s picture

I'd so like to keep this as "primary_menu" and "secondary_menu" region keys. Can we just suffix the regions with " Region" to avoid confusion? Or just rename the labels slightly?

-1 to header_first/header_second and renaming the regions in code at this time

Can we look for a cosmetic fix here?

dcrocks’s picture

StatusFileSize
new77.27 KB

Adding a suffix of _region seems redundant in the context in which they are displayed. We could adopt pre_header and post_header or we could adopt a triplet of header_first/_content/_last, or header_top/_content/_bottom. None of these indicates what is in those regions while hinting their layout. It will just make the patch slightly larger. And I'm slightly against having region names the same as the semantic unit they belong to(region 'header' inside <header>).
One of the issues is because the block ui lists regions in the order they are defined in info.yml, not in their order in the theme layout. How would users react if they saw the block ui page in the attached image? We could recommend that regions be defined in info.yml in the order they appear in the theme layout but none of the current core themes follow that practice.
I also think the conceptual issue reported in the issue summary wasn't specific to primary and secondary menu. They just happened to be first on the page. The names may violate best practice, but it would be nice to keep them.

dcrocks’s picture

Just a nit. I've always disliked the block ui because the table displayed is really indexed by region though the label above the first column says BLOCK and the column labeled REGION contains a selector for the assigned region. I understand the table but found the column labeling confusing the 1st time I saw it. You could change the BLOCK label to REGION >> BLOCK.

prajaankit’s picture

Status: Needs work » Needs review
StatusFileSize
new9.06 KB
dcrocks’s picture

Is this a re-roll or did you make changes?

dcrocks’s picture

This is a minimalist change. Internally the region name remains primary and secondary menu but the label displayed is 'Pre header' and 'Post header'. It amounts to a 2 line change.

dcrocks’s picture

Opps. If this is accepted I'll have to change the default region list also. 4 lines.

Status: Needs review » Needs work

The last submitted patch, 22: 2513526-22_Rename_the_menu_regions_in_Bartik.patch, failed testing.

Status: Needs work » Needs review
dcrocks’s picture

A decision should be made soon, it doesn't really help to drag this out. My understanding of status as of now:

We should leave 'header' region as is. A change here would have impact on other issues currently in process and require changes to at least 4 tests. Not sure it is worth it.

3 possible solutions:
1) Do nothing and rely on changes elsewhere to improve concerns raised in summary.
2) Rename primary_menu and secondary_menu regions thru out bartik code. API impact because of sites currently using these region names.
3) Leave the machine names for primary and secondary menus the same but change the human readable name to something that reflects best practices. This is really just a cosmetic change and won't entail api change.

So far suggested names for the 2 regions include:
header_first/top/start/begin
header_second/bottom/end/last
navigation_top/bottom
begin/start/top/pre/ante_header
end/finish/bottom/post_header

davidhernandez’s picture

Honestly, I think emma.maria should be the one making the call on region names and I don't see any comments from her yet. I'm tagging for maintainer review.

joelpittet’s picture

Assigned: Unassigned » emma.maria

#22 is the direction I am hoping for, thanks for considering it @dcrocks. The names may not be right but it doesn't cause too much fuss around renaming all the things and less disruptive of a patch in general if it will be enough?

To me "Navigation" is a nice catch all for menus, pagers, etc and may help.

So throwing in "Primary Navigation" and "Secondary Navigation" into the mix to help distinguish the Menu block from the Region.

I'd leave the call to @emma.maria though.

lewisnyman’s picture

We should leave 'header' region as is. A change here would have impact on other issues currently in process and require changes to at least 4 tests. Not sure it is worth it.

it's worth it. We shouldn't ship D8 with these region names and we still are within scope of changing them in beta. Bartik is supposed to be an example of best practices. This is the same as renaming 'main menu' to 'header menu'.

To me "Navigation" is a nice catch all for menus, pagers, etc and may help.

This doesn't solve the problem, it's confusing because regions can contain any content, not just menus and pagers. Calling them 'Primary Navigation' is describing the content, not the region.

dcrocks’s picture

@LewisNyman 'header' - It is doable but is an api change for current themes. I had considered header_content or header_main. Do you have a suggestion?

joelpittet’s picture

@LewisNyman good points... can we do without a new region then for these blocks? AKA remove them?

dcrocks’s picture

The only other region currently available to place blocks is 'header'. And bartik's current page.html.twig is hardcoded to add system logo, slogan, and site name. The menus are supposed to sandwich that code so it would be very difficult to lay that out properly by placing them in a region that is rendered after that code. That will change after #2005546: Use branding block in place of page template branding variables (site name, slogan, site logo) but I think that issue's 'branding' block will be placed in 'header' as its region.

dcrocks’s picture

StatusFileSize
new549 bytes
new78.26 KB

Because I had time. This is strictly cosmetic for bartik only. But for the long term, all 3 regions should be renamed.

lewisnyman’s picture

@joelpittet I think we have a requirement to maintain those regions, because we need some way of replacing the 'main-menu' with any other menu and maintaining the same styling. The region was chosen as a way of applying a common class to any menu to trigger the styling. I can't think of a better way of doing this in D8.

joelpittet’s picture

:( can't win one way can't win the other...

manjit.singh’s picture

StatusFileSize
new265.03 KB

menu regions are renamed now. check screenshots.

dcrocks’s picture

Renamed where?

dcrocks’s picture

I tried to see if this could be done with css alone and it doesn't look simple. The styling for these menus is tied to them being in these regions. Put them in another region and they only have default menu styling. Put other menus in these regions and they will acquire styling written for the primary and secondary menus. I tried both cases and they result in unsatisfactory output.
I may be wrong but I thought the styling on blocks is supposed to be region agnostic. It isn't on these 2 blocks. Since it is apparent in bartik that these 2 regions are targeted to have these 2 menus, and these 2 only, why is it wrong to have the region name indicate the content it is targeted for?
Lastly, I thought the purpose of regions was to create layout and to optionally provide common styling attributes for their content. In bartik they are treated as components, which seems odd to me.
And why is a class name(site-footer) treated as a component?

lewisnyman’s picture

Status: Needs review » Needs work

@dcrocks @joelpittet We should keep the machine names inline with the visible names. That's going to be really confusing for developers otherwise.

I tried to see if this could be done with css alone and it doesn't look simple. The styling for these menus is tied to them being in these regions.

I think we can add a class by overriding the region.twig.html file in Bartik. Something like:

if region == 'header_second'
classes[] = 'primary-menu'
emma.maria’s picture

Assigned: emma.maria » Unassigned

I think the regions should be called.

header_first: 'Header first'
header_second: 'Header second'
header_third: 'Header third'

This follows the same patterns used for other regions. The region names should not hint at what content they have, as they in theory could contain anything. The only thing the names need to convey is that they are all found within the header section of the markup with a number hierarchy to distinguish them from each other.

Also each region needs to be assigned with first, second etc, we can't have one that is just called 'header' on it's own.

The names in #33 are not immediately logical to the user and break the patterns of other grouped regions in Bartik.

Please can we have a patch with Header first, header second, header third.

If tests break because we are renaming regions we will have to fix them. We should not implement a half fix or just a cosmetic fix as we are trying to fix usability here.

dcrocks’s picture

I'll start work on this but I want to point out the 'featured-top' and 'featured-bottom' also break the pattern. If that pattern is allowed might we consider the top/main/bottom pattern for header?

ps. and we also have page top/bottom

manjit.singh’s picture

Status: Needs work » Needs review
StatusFileSize
new561 bytes

Added Header regions as per feedback by Emma in #42, See if it breaking structure or not ;)

Status: Needs review » Needs work

The last submitted patch, 44: 2513526-44_Rename_the_menu_regions_in_Bartik.patch, failed testing.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new24.8 KB

This patch is probably incomplete. It:

Does region name rename only
It ignores changes to these same files currently being worked on in other issues.
It doesn't change maintenance page files or css
Doc changes should include modules/help/help.php.api

Status: Needs review » Needs work

The last submitted patch, 46: 2513526-46_Rename_the_menu_regions_in_Bartik.patch, failed testing.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new25.97 KB

Another try. I had forgotten Classy. The problems are in some of the block tests but not sure yet what the problem is.

Status: Needs review » Needs work

The last submitted patch, 48: 2513526-48_Rename_the_menu_regions_in_Bartik.patch, failed testing.

dcrocks’s picture

Know what it is, fix tomorrow.

emma.maria’s picture

@dcrocks:
Featured top and bottom do not sit next to each and are supplementary regions to the Main content. Featured bottom also consists of three regions so the Top | Bottom naming convention was needed.

Bartik has one header that consists of three regions that come after each other, so the first | second | third naming convention works well here.

Also @dcrock's can you merge your patch with @Manjit.Singh's patch in #36 and carry on with the work. You did not review his patch before posting your own and his work had a correct start to the solution, the same code in your patch has whitespace at the start of the lines.

Thanks.

dcrocks’s picture

#36 doesn't have a patch. @manjit.Singh's last patch was in #44, and only changes bartik.info.yml, which has been done in all my patches. And all the region definitions in bartik.info.yml have whitespace at the start of the line.
I am hoping this patch will fly.

dcrocks’s picture

Status: Needs work » Needs review

bump

tim.plunkett’s picture

We'll have to fix all the placed blocks.

dcrocks’s picture

I was worried about migration issues. Where is that done? I am also still worried about the system maintenance page.

emma.maria’s picture

#52: OK sure. I noticed the following from your patch in dreditor and I got mixed up.

dcrocks’s picture

@emma.maria I'm not sure why the patch looks like that but if you look at the generated code everything is fine. Maybe has to do with git and tabs?

lewisnyman’s picture

Status: Needs review » Needs work

@dcrocks That happens when you have whitespace in the file. You can set up your text editor to trim the whitespace and use spaces instead of tabs: https://www.drupal.org/node/1346890

dcrocks’s picture

Status: Needs work » Needs review

What's there works, but needs review.

lewisnyman’s picture

Status: Needs review » Needs work

@dcrocks What do you want tested? There are formatting issues in the patch that need to be fixed.

lauriii’s picture

Assigned: Unassigned » lauriii
StatusFileSize
new26.44 KB
new702 bytes

Working on the upgrade path

dcrocks’s picture

The patch needs to be tested for visual regressions and the code reviewed, even though it is mostly substitutions..

lauriii’s picture

Maybe it would be good idea to add the changed region names to the IS

lauriii’s picture

Issue tags: +Needs beta evaluation
dcrocks’s picture

Issue summary: View changes

Is update

lauriii’s picture

Title: Rename the menu regions in Bartik » Rename the menu regions
Component: Bartik theme » theme system

We also need to update the issue to contain other themes and core because they seem to have the same regions too.

lauriii’s picture

Assigned: lauriii » Unassigned
Issue tags:
StatusFileSize
new0 bytes

Posting my progress. Broken upgrade path which cannot handle themes which this shouldn't affect etc. We also need tests for that.

lewisnyman’s picture

Issue tags:
+++ b/core/modules/system/templates/page.html.twig
@@ -88,11 +88,11 @@
-    {{ page.header }}
+    {{ page.header_second }}
...
-  {{ page.primary_menu }}
-  {{ page.secondary_menu }}
+  {{ page.header_third }}
+  {{ page.header_first }}

Also we noticed that the order of the regions in the page template does not match the names of the regions. I don't see a reason to choose his order.

lauriii’s picture

StatusFileSize
new27.53 KB
new1.93 KB

Ups empty patch

lauriii’s picture

@lewisnyman: I fixed that already in my patch

dcrocks’s picture

Issue summary: View changes
Status: Needs work » Needs review

IS update.

lauriii’s picture

Status: Needs review » Needs work

Nothing to review

longwave’s picture

+++ b/core/themes/bartik/templates/page.html.twig
@@ -48,10 +48,10 @@
+ * - page.header_first: Items for the secondary menu region.
+ * - page.header_second: Items for the header region.
+ * - page.header_third: Items for the primary menu region.

Comments don't match the region names.

What do we need to do about the upgrade path? For Bartik it should be (reasonably) straightforward, but what about a custom theme that extends Classy? If they have overridden page.html.twig don't they need to update their template to match?

tim.plunkett’s picture

We have to load all blocks using the old region names and resale them with new ones.

longwave’s picture

+function system_update_8001() {
+  /* @var \Drupal\block\BlockInterface[] $blocks */
+  $blocks = entity_load_multiple_by_properties('block', ['region' => 'header']);
+  foreach ($blocks as $block) {
+    $block->setRegion('header_first');
+    $block->save();
+  }

That is what the update hook does in the latest patch, but this does this blindly for all themes. We can limit this to Bartik or Classy by adding an extra property condition, but we also need to consider subthemes of Classy, but only if they relied on the default regions and didn't provide their own custom "header" region in the theme info file. And if they used the defaults, we will still break their theme if they have a custom page.tpl.php that refers to the old region names.

dcrocks’s picture

Read the IS. That is exactly what is expected if this issue is committed.

lewisnyman’s picture

Can we get a clarification that we can change templates still? The beta rules say we can, but the upgrade path says we can't?

It would be really sad if we are stuck with these region names for the whole of Drupal 8.

davidhernandez’s picture

@Lewis, we can change templates and regions. The problem is we now need upgrade hooks to move anything that was in the region we removed/renamed to put those blocks into the new regions, so the blocks aren't orphaned. If we don't, when someone updates their site they'll get those "block set to region that doesn't exist..." errors, or whatever it says.

lewisnyman’s picture

So if someone has overridden the default page.html.twig - it's ok that it will break now? We can just provide a change record?

longwave’s picture

In this patch I fixed the comments, moved the update hook to block.install, and started writing a test. But the test fails, I think because block_rebuild() fires before the update hook is run, so the blocks are already disabled by the time we try to move them.

longwave’s picture

Status: Needs work » Needs review

Status: Needs review » Needs work

The last submitted patch, 80: 2513526-menu-regions-80.patch, failed testing.

dcrocks’s picture

You missed the comments in modules/system/templates/page.html.twig. I mapped the regions to reflect the order in which they appeared in bartik's output, you used their original order in comments. 6 of one, half dozen the other.

dcrocks’s picture

The update places the blocks as

'header' in 'header_first'
'secondary_menu' in 'header_second'
'primary_menu' in 'header_third'

.
But the test assumes 'secondary_menu' is in 'header_first'. Need to decide what placement order is desired as inconsistent now. Perhaps follow the order define in ThemeHandler.php?

'header' in 'header_first'
'primary_menu' in 'header_second'
'secondary_menu' in 'header_third'
davidhernandez’s picture

Issue tags: +Needs change record

RE #79 yes, templates are not frozen so we can make changes to them. We should have change records for changes to page template because of the significance of the template, and adding or removing variables/regions from the default template is pretty significant.

What we need an update hook for is the blocks. Changing the block regions is like a schema change, since the values are stored in the database. It won't affect a theme that defines its own regions (nor would the page template changes) but a theme using the defaults will have a problem.

Adding change record tag. We need one for the region changes.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new29.09 KB

I made the small changes I indicated in #83 and #84.

Status: Needs review » Needs work

The last submitted patch, 86: 2513526-86_Rename_the_menu_regions.patch, failed testing.

emma.maria’s picture

@dcrocks from your comment #84 I just need to check the following is being set.

With the ordering of Bartik's current regions, the region changes should be:

Secondary menu -> Header first
Header -> Header second
Primary menu -> Header third.

lauriii’s picture

@dcrocks: could you please post an interdiff while you change something to make it easier to follow what has been changed between patches. Yoi can find the documentation about how its done here.

dcrocks’s picture

@emma.marie That has been the pattern I've been following but the patch in #80 suggested a possible different choice. Thanx for the direction.

@laurii Sorry, I'm not adept with Git, but I'll try to follow best practices from here on.

rainbowarray’s picture

@dcrocks: Here are some instructions on making an interdiff. Fairly similar to making a patch. You just need to branch off 8.0.x to commit the last patch, and then you can diff between the branch you are working on and that up-to-date last-patch branch, in order to show the changes from one patch to another. It really helps to see what work someone is doing when posting a patch. When you are doing a reroll, an interdiff isn't necessary because there are too many changes. At all other times, interdiffs make life easier! Thanks!

rainbowarray’s picture

dcrocks’s picture

Thanx for the pointers.

dcrocks’s picture

I am trying to get my head around this problem with the update. If @longwave is right the blocks are already disabled when the update fires and that's why the test fails. The impact should be that the user sees a bunch of standard blocks in their 'disabled' blocks list and a empty header region in Bartik. If the toolbar is not turned off, it is relatively easy to fix things up. But if not, and for other profiles than the standard one, things aren't quite so simple. So is there any place else to handle this, perhaps in theme handling or info file processing?

longwave’s picture

Status: Needs work » Needs review
StatusFileSize
new27.46 KB
new28.9 KB

Rebased #86 as block_update_8001() is now taken. If I remove block_rebuild() entirely then the failing test passes, but that is obviously not the right solution - but I am also not sure what the correct thing actually is.

Status: Needs review » Needs work

The last submitted patch, 95: 2513526-menu-regions-95-no-block-rebuild.patch, failed testing.

lauriii’s picture

According to test bot it seems to be opposite :P

dcrocks’s picture

Neither patch actually includes the HeaderRegionRenameUpdateTest.php, so no surprise the first passed.

lauriii’s picture

There is a long discussion which has been happened when this was done: #1869476: Convert global menus (primary links, secondary links) into blocks so this wasn't done by a mistake which I was assuming in the first place. The reason it was done in the first place was that we used to have an UI for selecting primary menu and secondary menu which are being outputted in the variables and we didn't want to remove. To support that we created them as separated regions so that themes could theme their menus according what's inside that region and site builders could change the menu inside the region. Apparently people don't know how it work. It was super confusing and even I couldn't figure out how I'm supposed to use those regions before reading the original issue. I think we either need to add a help text there or rename the regions at least on the UI so that its clear what they are there for.

longwave’s picture

Status: Needs work » Needs review
StatusFileSize
new28.97 KB
new30.4 KB

That's what I get for trying to post patches in a hurry before going to sleep. This is #95 with the missing test added back.

longwave’s picture

#1869476-187: Convert global menus (primary links, secondary links) into blocks and #1869476-188: Convert global menus (primary links, secondary links) into blocks certainly do make good arguments for the way things currently are, and after scanning that entire issue there seems to be no single perfect solution that will please everyone. Maybe the current setup is the least worst option, and adding help text to explain the use of Bartik's regions would improve things? Header first/second/third may remove some of the confusion but that does not follow that it will necessarily make the blocks page any more usable.

lewisnyman’s picture

We have a three competing objectives here:

  1. Support the ability to use any menu that will look like the primary-navigation and secondary-navigation design components without writing code
  2. Conform to our CSS standards by allowing the reuse of design component anywhere on the page
  3. Best practice for region names, which can contain any content
  4. The usability of the solution, making it clear that the can switch the menu as in Drupal 7. The UI is now more abstract and less clear

I think we can solve the first three by renaming the regions to follow best practice, then adding a custom class to these regions that have no relation to the region name. This means the menu styling is still triggered by placing the block in the region but it is still reusable elsewhere.

The final objective, we could improve using some help text, a tooltip, or tour. That feels like a separate issue to me.

dcrocks’s picture

#2502045: Replace the "Primary menu" component with a reusable component in Bartik. and #2502049: Replace the "Secondary menu" component with a reusable component in Bartik. are meant to address part of @LewisNyman's comments in #102. This issue was supposed to just address the region renaming.

Status: Needs review » Needs work

The last submitted patch, 100: 2513526-menu-regions-100-no-block-rebuild.patch, failed testing.

The last submitted patch, 100: 2513526-menu-regions-100-rebased.patch, failed testing.

dcrocks’s picture

This has been sitting for a while. I don't think I quite understand the update process but if we simply update the block config but the theme definition hasn't been updated we will still have a mismatch between the block region designation and the theme's region definitions. What I would expect that for any block configured for a region that doesn't exist in a given theme the block would be placed in the theme's default region, which, I think, is the 1st region defined in that theme's info.yml. And unless the theme has the old region names, we can't mess with it. Even then we aren't really sure what the consequences of that change would be on the theme. So, is it actually possible to have an update mechanism for this change?

dcrocks’s picture

StatusFileSize
new28.67 KB
new1020 bytes

It seems to me that we can't do any updates to custom themes as we don't know the themer's intent. All we can update is the bartik theme, and even there we might step on some local modifications. And the test added only tests the bartik theme anyways. So I modified the update to just do a forced update of the bartik account menu and main menu blocks.

dcrocks’s picture

Status: Needs work » Needs review

duh

dcrocks’s picture

StatusFileSize
new28.67 KB

Small typo, big fail

The last submitted patch, 107: 2513526_menu-regions-107.patch, failed testing.

Status: Needs review » Needs work

The last submitted patch, 109: 2513526_menu-regions-109.patch, failed testing.

dcrocks’s picture

StatusFileSize
new29.55 KB
new1.89 KB

Why didn't we get this earlier? Just duplicate dpattern of other updates.

dcrocks’s picture

Status: Needs work » Needs review

duh again

Status: Needs review » Needs work

The last submitted patch, 112: 2513526_menu-regions-112.patch, failed testing.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new29.54 KB

Need to finish. There will be multiple patches affected by #2555183: Fix the filled update tests, they are broken.

Status: Needs review » Needs work

The last submitted patch, 115: 2513526_menu-regions-114.patch, failed testing.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new29.52 KB
new698 bytes

another typo, but I'm concerned about all the other errors.

tim.plunkett’s picture

+++ b/core/modules/block/block.install
@@ -142,5 +142,18 @@ function block_update_8002() {
+  $block = entity_load('block', 'bartik_account_menu');
+    $block->setRegion('header_first');
+    $block->save();

a) The other two update hooks use the config objects directly, bypassing the entity system. Why doesn't this do the same?

b) If you continue to load the entity, please do it like

Block::load('bartik_account_menu')
  ->setRegion('header_first')
  ->save();

Also, a lot the "needs" tags can be resolved without the intervention of others (like BE and IS update), and will actually help others review this.

andypost’s picture

just a nit

+++ b/core/modules/block/block.install
@@ -142,5 +142,18 @@ function block_update_8002() {
+  $block = entity_load('block', 'bartik_account_menu');
+    $block->setRegion('header_first');
+    $block->save();
+  $block = entity_load('block', 'bartik_main_menu');
+    $block->setRegion('header_third');
+    $block->save();

indent wrong, also better to use Block::load()

dcrocks’s picture

StatusFileSize
new29.46 KB
new1.28 KB

This is a reroll after #507488: Convert page elements (local tasks, actions) into blocks and for the recommendations in #118. I would like to take a stab at using config instead of the entity system but I wanted to try this first.

dcrocks’s picture

StatusFileSize
new29.58 KB
new312 bytes

Know that will fail, so trying again.

The last submitted patch, 120: 2513526-menu-regions-120.patch, failed testing.

rainbowarray’s picture

If we can get it in, #2005546: Use branding block in place of page template branding variables (site name, slogan, site logo) will affect what content is in the header. That's RTBC, so a heads-up.

dcrocks’s picture

This is not the only one impacted. It would make sense for #2005546: Use branding block in place of page template branding variables (site name, slogan, site logo) to go in first.

dcrocks’s picture

I don't know the original decision to use the entity system came about but what would be the advantage of using config objects over the entity system?

tim.plunkett’s picture

$entity->save() dispatches events and invokes hooks. Those can be unsafe during update.

dcrocks’s picture

StatusFileSize
new29.65 KB
new739 bytes

Using config instead of entity

tim.plunkett’s picture

StatusFileSize
new29.67 KB
new949 bytes

There are a *lot* of "needs" tags on this issue...

Fixing the coding style of the last patch.

dcrocks’s picture

Sorry. I was planning on doing that when this needs a re-roll, as I expect #2005546: Use branding block in place of page template branding variables (site name, slogan, site logo) to go in first. Should probably remove "use Drupal\block\Entity\Block;" from block.install as well. I can remove tags but I didn't add them so I'm leery about changing them.

dcrocks’s picture

Status: Needs review » Needs work

The last submitted patch, 130: 2513526-menu-regions-130.patch, failed testing.

The last submitted patch, 130: 2513526-menu-regions-130.patch, failed testing.

dcrocks’s picture

Issue summary: View changes
Status: Needs work » Needs review
Issue tags: -Needs beta evaluation
StatusFileSize
new838 bytes
new36.62 KB

This won't fix the fail, just doing a little clean up.

dcrocks’s picture

Ok, now needs review and change record.

rainbowarray’s picture

  1. +++ b/core/modules/system/templates/page.html.twig
    @@ -58,11 +58,11 @@
       <header role="banner">
    -    {{ page.header }}
    +    {{ page.header_second }}
       </header>
     
    -  {{ page.primary_menu }}
    -  {{ page.secondary_menu }}
    +  {{ page.header_third }}
    +  {{ page.header_first }}
    

    We're naming these regions numerically, but the order is 2, 3, then 1?

    It seems like the region number should match the source order.

  2. +++ b/core/themes/classy/templates/layout/page.html.twig
    @@ -56,11 +56,11 @@
       <header role="banner">
    -    {{ page.header }}
    +    {{ page.header_second }}
       </header>
     
    -  {{ page.primary_menu }}
    -  {{ page.secondary_menu }}
    +  {{ page.header_third }}
    +  {{ page.header_second }}
    

    header_second is used twice here. Should the first one be header_first?

dcrocks’s picture

This is the order in Bartik and matches the placement of the blocks in Bartik. It is not the same order in page.html.twig files in system or classy. It is the order that @emma.maria had asked for back in #42.

davidhernandez’s picture

Status: Needs review » Needs work

mdrummond's comment wasn't about the name of the regions, but the order and placement in the template. It indeed looks wrong. They should be in order and not duplicated.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new1 KB
new36.62 KB

When I 1st set it up I was thinking in terms of the content more than the region. This patch changes all core page.html.twig templated to have the same order,

Status: Needs review » Needs work

The last submitted patch, 138: 2513526-menu-regions-138.patch, failed testing.

Status: Needs work » Needs review

Status: Needs review » Needs work

The last submitted patch, 138: 2513526-menu-regions-138.patch, failed testing.

Status: Needs work » Needs review
manjit.singh’s picture

@dcrocks should not the order be same for bartik as well ?

+++ b/core/modules/system/templates/page.html.twig
@@ -58,11 +58,11 @@
   <header role="banner">
-    {{ page.header_second }}
+    {{ page.header_first }}
   </header>
 
+  {{ page.header_second }}
   {{ page.header_third }}
-  {{ page.header_first }}
 
   {{ page.breadcrumb }}
 

Status: Needs review » Needs work

The last submitted patch, 138: 2513526-menu-regions-138.patch, failed testing.

dcrocks’s picture

The header regions appear in the same order in all of the core page.html.twig files; system. classy, and bartik.

Status: Needs work » Needs review

Status: Needs review » Needs work

The last submitted patch, 138: 2513526-menu-regions-138.patch, failed testing.

The last submitted patch, 138: 2513526-menu-regions-138.patch, failed testing.

Status: Needs work » Needs review

Status: Needs review » Needs work

The last submitted patch, 138: 2513526-menu-regions-138.patch, failed testing.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new36.62 KB
new1.18 KB

Spent too much time looking at wrong ThemeTest.php.

Status: Needs review » Needs work

The last submitted patch, 151: 2513526-menu-regions-151.patch, failed testing.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new572 bytes
new36.62 KB

Small change but faster thn waiting for 151 to finish

dcrocks’s picture

Well I know that will blow up because somebody else grabbed update 8003

dcrocks’s picture

StatusFileSize
new36.62 KB
new503 bytes

Quick fix

The last submitted patch, 153: 2513526-menu-regions-153.patch, failed testing.

rainbowarray’s picture

Something to think about:

- You may want to check the block configs for the minimal and standard profiles to check which regions each block is being placed into: those may need to change so they still show up in the right spot.
- We'll probably need an upgrade path for this. We can't do much for custom themes, but we can check for Stark, Seven, Classy and Bartik to move blocks in regions whose names are changing to the corresponding new regions that take up the same place in the layout.

The last submitted patch, 151: 2513526-menu-regions-151.patch, failed testing.

dcrocks’s picture

Note that seven has only one header region and that wasn't touched by this patch. Classy and stark inherit the default theme definitions in ThemeHandler.php.
Using a git clone of 8.0.x and applying the patch, after install:

On a minimal install:
stark is the default theme and its blocks are assigned regions as configured.
All the other themes are in the 'uninstalled' state.
When installed they will inherit blocks from whatever blocks are in the current default them plus 'Site Branding' which is placed by system.install.

On a standard install:
Bartik, Classy, and seven are in the 'installed state' and blocks are assigned as configured.
Classy has no blocks assigned to any region, which is as designed.
Stark is in the 'uninstalled' state and when installed will pick up whatever blocks are assigned to the current default theme in the corresponding regions, if it exists.

The only possible additions I can see at this time is to have additional blocks, such as primary or secondary menus for stark, placed by system install.
There is a minimalist upgrade path and I'm not sure how it can be added to.

The last submitted patch, 153: 2513526-menu-regions-153.patch, failed testing.

dcrocks’s picture

StatusFileSize
new61.63 KB
new59.13 KB
new35.13 KB
new33.65 KB
new31.81 KB
new37.22 KB
new2.73 KB
new37.19 KB

Re-roll to include changes from #2503755: Switch from user login block to login menu link and search block in standard profile and some before and after shots.

Status: Needs review » Needs work

The last submitted patch, 161: 2513526-menu-regions-161.patch, failed testing.

Status: Needs work » Needs review
dcrocks’s picture

I just noticed that RC1 has arrived. Given that, this patch will be much more disruptive since the number of users will be much higher than the number on the betas, and also probably less experienced. Much as I hate to say it, it might be better to postpone this.

Status: Needs review » Needs work

The last submitted patch, 161: 2513526-menu-regions-161.patch, failed testing.

The last submitted patch, 161: 2513526-menu-regions-161.patch, failed testing.

longwave’s picture

Version: 8.0.x-dev » 8.1.x-dev
Status: Needs work » Postponed

Unfortunately, this does not appear to meet the allowed changes criteria for 8.0.x now, so I agree this must be postponed until 8.1.x.

Status: Postponed » Needs review

Status: Needs review » Needs work

The last submitted patch, 161: 2513526-menu-regions-161.patch, failed testing.

dcrocks’s picture

Status: Needs work » Postponed
davidhernandez’s picture

Status: Postponed » Needs review

You don't have to actually postpone it. It can still be worked on, just not committed. The change in version is the clear indicator that it would not get committed to 8.0 and have to wait to be added to 8.1.x-dev.

Though, admittedly, I'm not sure this could even go in 8.1. Changing the default regions is a change that we can only provide limited backwards compatibility for. We might have to leave that change for 9. All the changes to Bartik and Seven we can make though to some version of 8 after release.

dcrocks’s picture

Doesn't look like 8.1.x is synced with RC so can't work on that branch at all and as long as issue assigned to 8.1.x can't work on it as 8.0.x either.

Version: 8.1.x-dev » 8.2.x-dev

Drupal 8.1.0-beta1 was released on March 2, 2016, which means new developments and disruptive changes should now be targeted against the 8.2.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

joelpittet’s picture

I think/hope we can do this in 8.2.x. The plan though is that we can't change classy or stable. But all other themes/core is fair game.

This should be a good test of how much we can test in the name of UX for the themes we want to improve and for core and still giving backwards compatibility for 8.x

joelpittet’s picture

Here's a reroll of #161

Status: Needs review » Needs work

The last submitted patch, 175: rename_the_menu_regions-2513526-175-reroll.patch, failed testing.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new39.18 KB
new6.55 KB

Another reroll of 161

Status: Needs review » Needs work

The last submitted patch, 177: 2513526-menu-regions-177.patch, failed testing.

joelpittet’s picture

@dcrocks Thanks that re-roll looks better than mine.

joelpittet’s picture

@dcrocks Could you remove the classy and stable bits of this patch?

dcrocks’s picture

So you want classy and stable to maintain the old region names? Neither classy nor stable specify regions in their info.yml but they have templates that do. I don't expect issues but I guess we will have to wait and see.

dcrocks’s picture

Status: Needs work » Needs review
StatusFileSize
new6.03 KB
new43.4 KB

This will probably not fix everything. I'd like to add that this would be easier if non-stable themes were not used in testing unless they themselves were being tested.

Status: Needs review » Needs work

The last submitted patch, 182: 2513526-menu-regions-182.patch, failed testing.

dcrocks’s picture

This has turned into a real mess. Reverting classy to use the old region names has created all kinds of conflicts. It made tests that use classy now fail because the page.html.twig file has the old names and I have to find and revert all those tests. This also affects tests that use stark because it inherits from classy. But that is not the hard problem. Since the existing block yml files are actually written for bartik, if they are run in tests that use classy(or stark) as the theme, the tests fail. I'd like to restart and make this a bartik only change but for the problem with the block yml files. If #2642590: Move Bartik block config into the Bartik theme and its brethern were in, it would make any solution here safer for the long run.

So, bartik, classy, stable, and system all carry these region definitions around in page.html.twig, plus some core block yml files that are designed for bartik(eg. system branding) but used in tests with other themes. Honestly, I'd prefer they all used the new names because they are more generic and not bartik centric.

dcrocks’s picture

I know we can't modify classy and stable, and we probably shouldn't touch any templates in system module as well. I could redo this and focus just on bartik. That means bartik would look very different from default region setups in the rest of drupal core, including the default region definitions in ThemeHandler.php. Maybe that's for the better, maybe it will just create confusion, and maybe it's not worth the effort.
The original issue scope really was to change this in all of Drupal. If that is still the intent, then maybe this has to be moved to 9.x.

ps. If this is done in 8.x I would like to change the tests impacted by this change to NOT use bartik unless they actually have to. Its a pain to have to fix tests because they chose a moving target for a theme and don't really see a functional change.

dcrocks’s picture

To be clear, I am looking for input as to whether to continue with this or not.

dcrocks’s picture

Version: 8.2.x-dev » 9.x-dev
Status: Needs work » Postponed

I am going to mark this as postponed and for 9.x for several reasons:

The old region names are already embedded in existing 8.x sites.

The original issue posed this as a core wide change. Having both the old and bartik specific regions names will probably lead to some confusion(and cursing). If this is done for Bartik only, then themes that think they are inheriting bartik's menu blocks will find them disabled because the block's menu regions don't exist in the new theme's layout.

catch’s picture

Version: 9.x-dev » 8.3.x-dev

This is still worth trying in a minor release, moving back for now.

Version: 8.3.x-dev » 8.4.x-dev

Drupal 8.3.0-alpha1 will be released the week of January 30, 2017, which means new developments and disruptive changes should now be targeted against the 8.4.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.4.x-dev » 8.5.x-dev

Drupal 8.4.0-alpha1 will be released the week of July 31, 2017, which means new developments and disruptive changes should now be targeted against the 8.5.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.5.x-dev » 8.6.x-dev

Drupal 8.5.0-alpha1 will be released the week of January 17, 2018, which means new developments and disruptive changes should now be targeted against the 8.6.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.6.x-dev » 8.7.x-dev

Drupal 8.6.0-alpha1 will be released the week of July 16, 2018, which means new developments and disruptive changes should now be targeted against the 8.7.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.7.x-dev » 8.8.x-dev

Drupal 8.7.0-alpha1 will be released the week of March 11, 2019, which means new developments and disruptive changes should now be targeted against the 8.8.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.8.x-dev » 8.9.x-dev

Drupal 8.8.0-alpha1 will be released the week of October 14th, 2019, which means new developments and disruptive changes should now be targeted against the 8.9.x-dev branch. (Any changes to 8.9.x will also be committed to 9.0.x in preparation for Drupal 9’s release, but some changes like significant feature additions will be deferred to 9.1.x.). For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 8.9.x-dev » 9.1.x-dev

Drupal 8.9.0-beta1 was released on March 20, 2020. 8.9.x is the final, long-term support (LTS) minor release of Drupal 8, which means new developments and disruptive changes should now be targeted against the 9.1.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 9.1.x-dev » 9.2.x-dev

Drupal 9.1.0-alpha1 will be released the week of October 19, 2020, which means new developments and disruptive changes should now be targeted for the 9.2.x-dev branch. For more information see the Drupal 9 minor version schedule and the Allowed changes during the Drupal 9 release cycle.

Version: 9.2.x-dev » 9.3.x-dev

Drupal 9.2.0-alpha1 will be released the week of May 3, 2021, which means new developments and disruptive changes should now be targeted for the 9.3.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.3.x-dev » 9.4.x-dev

Drupal 9.3.0-rc1 was released on November 26, 2021, which means new developments and disruptive changes should now be targeted for the 9.4.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.0-alpha1 was released on May 6, 2022, which means new developments and disruptive changes should now be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.5.x-dev » 10.1.x-dev

Drupal 9.5.0-beta2 and Drupal 10.0.0-beta2 were released on September 29, 2022, which means new developments and disruptive changes should now be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

steinmb’s picture

Status: Postponed » Needs work

See no reasons for this to be postponed.

Version: 10.1.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch, which currently accepts only minor-version allowed changes. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 11.x-dev » main

Drupal core is now using the main branch as the primary development branch. New developments and disruptive changes should now be targeted to the main branch.

Read more in the announcement.