Problem/Motivation

Review the help text for Migrate Drupal UI. This is a follow up to #2922701: Migrate UI - refer to modules and add help text, which changed the one line that was in scope, but it was pointed out in #47 of that issue

Also it's out of patch context but would change 'Lastly' to 'Finally'.

Are there any other suggestions?
Be aware that two new forms have been added, one for incremental migration and once to alert the user to D conflicts. See #10


Screenshots

Before

After

Proposed resolution

Change 'Lastly' to 'Finally'.

Remaining tasks

Review the help text.

User interface changes

Yes, the text at admin/help/migrate_drupal_ui

Comments

quietone created an issue. See original summary.

quietone’s picture

Status: Needs review » Postponed

Should be postponed

phenaproxima’s picture

Title: Migrate UI - review help text » [PP-3] Migrate UI - review help text

Postponed on a trifecta.

quietone’s picture

Title: [PP-3] Migrate UI - review help text » [PP] Migrate UI - review help text
Issue summary: View changes
heddn’s picture

Title: [PP] Migrate UI - review help text » Migrate UI - review help text
Status: Postponed » Active

No longer blocked.

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.

quietone’s picture

Issue summary: View changes
Status: Active » Needs review
StatusFileSize
new59.78 KB
new59.62 KB

Any other suggestions?

quietone’s picture

StatusFileSize
new1.59 KB

forgot the patch

quietone’s picture

Issue summary: View changes
StatusFileSize
new20.16 KB
new46.48 KB

Incremental upgrades has been added and well as check for ID conflicts. Both have their own display form. The help text does not refer to these forms. Should it? Or is that just too much detail.

For reference here are screenshots of those forms.

Incremental form
ID conflict form

heddn’s picture

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

Yes, it should show those.

quietone’s picture

Status: Needs work » Needs review
StatusFileSize
new1.63 KB

Just a reroll

quietone’s picture

Issue summary: View changes
StatusFileSize
new2.27 KB
new27.22 KB

Added some text for the incremental screen and the conflict screen. Creating nice UI text isn't my thing, so please somebody make some suggestions.

New screenshot in the IS

heddn’s picture

Some minor feedback.

  1. +++ b/core/modules/migrate_drupal_ui/migrate_drupal_ui.module
    @@ -25,9 +25,11 @@ function migrate_drupal_ui_help($route_name, RouteMatchInterface $route_match) {
    +      $output .= '<dd><ol><li>' . t('If an upgrade has been performed on this site you will informed.') . '</li>';
    

    Missing a word. Maybe its 'be'?

  2. +++ b/core/modules/migrate_drupal_ui/migrate_drupal_ui.module
    @@ -25,9 +25,11 @@ function migrate_drupal_ui_help($route_name, RouteMatchInterface $route_match) {
    +      $output .= '<li>' . t('You need to enter the database credentials of the Drupal site that you want to upgrade. You can also include its files directory in the upgrade.') . '</li>';
    

    It would be good to show examples or make it clear about local files (full path to them) vs remote files (fqdn + path to files).

rakesh.gectcr’s picture

Status: Needs review » Needs work

Need to make the changes according to @heddn comment. So moving to needs work

rakesh.gectcr’s picture

Assigned: Unassigned » rakesh.gectcr
rakesh.gectcr’s picture

StatusFileSize
new1.92 KB
new2.36 KB
rakesh.gectcr’s picture

rakesh.gectcr’s picture

Status: Needs work » Needs review
StatusFileSize
new2.36 KB
new1.92 KB

Tried addressing the last comment by @heddn.

rakesh.gectcr’s picture

Assigned: rakesh.gectcr » Unassigned
heddn’s picture

Status: Needs review » Needs work
+++ b/core/modules/migrate_drupal_ui/migrate_drupal_ui.module
@@ -25,9 +25,11 @@ function migrate_drupal_ui_help($route_name, RouteMatchInterface $route_match) {
+      $output .= '<li>' . t('You need to enter the database credentials of the Drupal site that you want to upgrade. You can also include its files directory in the upgrade. For example local files (/var/www/docroot) or remote files (fqdn + path to files).') . '</li>';

I think something like:

Examples of local files and remote files, respectively: /var/www/html or http://www.example.com.

And can we confirm we don't need to include sites/default/files, etc in these or if we do need it. I don't recall off the top of my head.

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.

quietone’s picture

Issue summary: View changes
Status: Needs work » Needs review
StatusFileSize
new2.36 KB
new19.8 KB
new29.58 KB

Updating the patch here, new screenshots. And I checked the definitions of 'finally' and 'lastly' and think 'lastly' is the better choice here. However, the patch doesn't have that to allow others to comment.

mikelutz’s picture

Status: Needs review » Reviewed & tested by the community

I think finally makes more sense here, it's the end of a dump of information, not a sequence.

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.

  • catch committed 1272ee6 on 9.2.x
    Issue #2939328 by quietone, rakesh.gectcr, heddn, mikelutz: Migrate UI...
catch’s picture

Status: Reviewed & tested by the community » Fixed

This looks like a good improvement - will be superceded eventually by the new help system, but that's fine can still make an incremental improvement that might or might not get carried over. Since it's new translations, 9.2.x-only at this point.

Committed 1272ee6 and pushed to 9.2.x. Thanks!

Status: Fixed » Closed (fixed)

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