Problem/Motivation

Mark module as fully stable. This has been postponed on some minor UX feedback identified in children of #2678638: [META] Usability refinements for Migrate UI and adding back incremental migrations to the UI.

Proposed resolution

  • Consider migrate_drupal_ui.module stable as of 8.6.0. The expectations for beta experimental modules are:
    • Beta experimental modules are considered API- and feature-complete. Some early adopters may begin using beta experimental modules on development sites, but should be aware that they are not yet fully supported and may contain bugs.
    • Developers can begin using beta modules' APIs, but should be aware that some things may still change to address bugs. Beta modules are subject to the beta allowed changes policy.
    • An upgrade path may be provided from beta versions, but be aware it may contain critical bugs.

    For RC:

    Release candidate (e.g. 8.y.x-rc)

    Release candidate (RC) experimental modules are essentially stable and may be release-ready, although some changes might be made to address critical bugs.
    RC modules are subject to the RC allowed changes policy.
    Upgrade paths are provided from release candidate versions.

    And for fully stable:

    Stable core modules
    Once an experimental module is judged stable, the module will be moved out of the Core (Experimental) package, and its version number and allowed changes will be the same as Drupal core's. Experimental modules may only become stable modules in minor or major releases. Not all experimental modules will necessarily become stable core modules.

Remaining tasks

#2905222: Migrate UI: Initial Screen UX improvements
#2905227: Migrate UI: Improve 'Review Upgrade' page UX
#2687843: Add back incremental migrations through the UI

Approvals

Needs signoff from Migrate maintainers and framework and release managers.

  • Migrate maintainer - Adam Globus-Hoenich (phenaproxima) - Approved (#12)
  • Migrate maintainer - Lucas Hedding (heddn) - Approved
  • Migrate maintainer - Markus Sipilä (masipila) - Approved in #27
  • Migrate maintainer - Vicki Spagnolo (quietone) - Approved #28
  • Migrate maintainer - Maxime Turcotte (maxocub) - Approved #14
  • Framework manager - ???
  • Release manager - ???

Comments

heddn created an issue. See original summary.

heddn’s picture

Title: Mark Migrate Drupal UI as beta » [policy, no patch] Mark Migrate Drupal UI as beta
Issue summary: View changes
heddn’s picture

Issue summary: View changes
heddn’s picture

Category: Task » Plan
heddn’s picture

Issue summary: View changes

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

Drupal 8.4.4 was released on January 3, 2018 and is the final full bugfix release for the Drupal 8.4.x series. Drupal 8.4.x will not receive any further development aside from critical and security fixes. Sites should prepare to update to 8.5.0 on March 7, 2018. (Drupal 8.5.0-alpha1 is available for testing.)

Bug reports should be targeted against the 8.5.x-dev branch from now on, and new development or disruptive changes should 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.

heddn’s picture

The final issue blocker for migrate_drupal_ui was just committed. That means this module is fully stable. Except it depends on migrate_drupal, which isn't stable. Due to this important dependency, I'm leaving this postponed until all of its issues are completed. At which time, the UI and migrate_drupal can go stable at the same time.

xjm’s picture

I agree with the proposal in #7. Thanks @heddn!

webchick’s picture

Title: [policy, no patch] Mark Migrate Drupal UI as beta » [policy, no patch] Mark Migrate Drupal UI as stable
webchick’s picture

Oops, I left my comment blank, sorry!

Updating the title based on #7.

phenaproxima’s picture

Issue summary: View changes

#2953360: Experimental migrate_drupal_multilingual module has landed, which officially makes all translation migrations experimental, since they all depend on an experimental module. Once #2905736: Mark Migrate Drupal as stable is in, I am in favor of marking Migrate Drupal UI stable as well. It is well-tested and being used for successful (monolingual) migrations.

+1.

heddn’s picture

Title: [policy, no patch] Mark Migrate Drupal UI as stable » Mark Migrate Drupal UI as stable
Version: 8.5.x-dev » 8.6.x-dev
Category: Plan » Task
Issue summary: View changes
Status: Postponed » Active

Based off the last time we did this, it was more awkward to do this as two issues. So switching this to a task and active.

Do we still need release and produce manager reviews?

I'm +1 on marking stable.

heddn’s picture

Status: Active » Needs review
StatusFileSize
new555 bytes

Here's a patch.

maxocub’s picture

+1 for stability

maxocub’s picture

Issue summary: View changes

Updated the IS

Status: Needs review » Needs work

The last submitted patch, 13: 2905491-13.patch, failed testing. View results

phenaproxima’s picture

Status: Needs work » Needs review

I'm pretty sure that was some kind of rando Nightwatch failure.

Status: Needs review » Needs work

The last submitted patch, 13: 2905491-13.patch, failed testing. View results

heddn’s picture

I think we need to update the test. Legit failure.

maxocub’s picture

I think this test will fail until #2905736: Mark Migrate Drupal as stable is commited. The test seems to try to enable all non-experimental modules, but Migrate Druapl UI depends on Migrate Drupal which is no stable in this patch.

maxocub’s picture

Status: Needs work » Needs review
StatusFileSize
new555 bytes
new1.01 KB

Just to make sure that the tests are green when both modules are stable.

Status: Needs review » Needs work

The last submitted patch, 21: 2905491-21-with-2905736-15.patch, failed testing. View results

maxocub’s picture

Status: Needs work » Needs review
StatusFileSize
new1.55 KB
new2.1 KB
new2.57 KB

It looks like we have to add the CSS of Migrate Drupal UI to the Stable theme. I never done this, but I looked at how it was done for content_moderation (#2897132: Mark Content Moderation module as stable).

masipila’s picture

Issue summary: View changes

The issue summary is currently talking about beta stability. If I'm not totally mistaken, the idea here is to declare Migrate Drupal UI as fully stable and not just beta so I updated the IS accordingly. The signoffs in #11 (phenaproxima), #12 (heddn) and #14 (maxocub) are all signing off for 'stable' and not just beta but if your signoffs were intended to be about beta stability and not full stability, yell loud and we can revert my IS updates.

Regarding the topic itself i.e. marking Migrate Drupal UI as fully stable. One of the beta criteria is that the module is considered API and feature complete. We still have this pending issue which is about how contrib modules can interact with Migrate Drupal UI, see #2936365: Migrate UI - allow modules to declare the state of their migrations

What do others think about this, should that land before we declare Migrate Drupal UI fully stable? That issue is currently categorized as 'Normal' and not 'Critical' but in my opinion it is quite important part of the Migrate Drupal UI. I'm OK that we add that later if that is acceptable in the release policy and if we jointly agree that it can be done after Migrate Drupal UI has been declared stable.

Cheers,
Markus

The last submitted patch, 21: 2905491-21-with-2905736-15.patch, failed testing. View results

catch’s picture

For me #2936365: Migrate UI - allow modules to declare the state of their migrations is a good addition we can make in a minor release, but shouldn't block this being marked stable.

masipila’s picture

Issue summary: View changes

+1 for declaring Migrate Drupal UI stable as per the previous comment #26.

quietone’s picture

Issue summary: View changes
Status: Needs review » Reviewed & tested by the community

@masipila, thanks for bringing up the point about #2936365: Migrate UI - allow modules to declare the state of their migrations. I'm glad that was addressed, although I'd like it's priority raised but that is a discussion for another time.

So, yes I agree that Migrate Drupal Ui can go stable.

gábor hojtsy’s picture

Stability changes should at least be signed off by release managers, so I asked @catch to take a look again.

catch’s picture

Yes happy for this to go stable, per #26 we can continue to make improvements in minor releases.

gábor hojtsy’s picture

Version: 8.6.x-dev » 8.7.x-dev
Status: Reviewed & tested by the community » Needs work
+++ b/core/themes/stable/css/migrate_drupal_ui/components/upgrade-analysis-report-tables.css
@@ -0,0 +1,23 @@
+.upgrade-analysis-report__status-icon--warning:before {
+  background-image: url(../../../../misc/icons/e29700/warning.svg);
+}
+.upgrade-analysis-report__status-icon--checked:before {
+  background-image: url(../../../../misc/icons/73b355/check.svg);
+}
+.upgrade-analysis-report__status-icon--error:before {
+  background-image: url(../../../../misc/icons/e32700/error.svg);
+}

This does not look like it would work, the module file it was copied from is in core/modules/migrate_drupal_ui/css/components/upgrade-analysis-report-tables.css, so going up directories up is the core/ directory which has misc in it.

However from core/themes/stable/css/migrate_drupal_ui/components/[].css it would be in /themes because this is one more directory deep.

maxocub’s picture

Status: Needs work » Needs review
StatusFileSize
new1.01 KB
new2.11 KB

Sorry about that. I manually tested this and it turns out that not only there was an extra "../", but the path was wrong. I look at the CSS for the Status report page and used the same paths and now the icons are correctly displayed.

masipila’s picture

I can RTBC this from my mobile if you provide screenshots demonstrating the fail and fix.

maxocub’s picture

With patch from #23:

With patch from #32:

masipila’s picture

Status: Needs review » Reviewed & tested by the community

Boom! Just in time before the dinner. Now offline. :)

catch’s picture

Version: 8.7.x-dev » 8.6.x-dev
Status: Reviewed & tested by the community » Fixed

Committed/pushed to 8.7.x and cherry-picked to 8.6.x. Thanks!

  • catch committed d735a62 on 8.7.x
    Issue #2905491 by maxocub, heddn, Gábor Hojtsy: Mark Migrate Drupal UI...

  • catch committed bdf7cbb on 8.6.x
    Issue #2905491 by maxocub, heddn, Gábor Hojtsy: Mark Migrate Drupal UI...
catch’s picture

Status: Reviewed & tested by the community » Fixed

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.