Problem: some wordy descriptions needlessly clutter installation pages, introduce Drupalese jargon that new users are not helped with.

Fix: reword, remove, shorten

UI impact: see screenshots for reviewed items.

CommentFileSizeAuthor
#38 interdiff-2098047-36-38.txt810 bytesDinesh18
#38 installer_ui_text_cleanup-2098047-38.patch2.02 KBDinesh18
#36 interdiff.txt1.62 KBDinesh18
#36 2098047-36.patch2.1 KBDinesh18
#33 installer-country-and-updates.png17.09 KBifrik
#33 installer-database-advanced.png11.8 KBifrik
#33 installer-database.png16.7 KBifrik
#33 installer-not-english.png12.12 KBifrik
#33 installer-english.png7.3 KBifrik
#31 interdiff-098047-28-31.txt1.21 KBpguillard
#31 installer_ui_text_cleanup-2098047-31.patch2.12 KBpguillard
#28 installer_ui_text_cleanup-2098047-28.patch1.68 KBpguillard
#23 installer_ui_text_cleanup-2098047-23.patch2.06 KBcbeier
#14 4.png20.44 KBchetan2111
#14 3.png36.34 KBchetan2111
#14 2.png42.69 KBchetan2111
#14 1.png15.99 KBchetan2111
#13 installer_ui_text_cleanup-2098047-13.patch1.98 KBpguillard
#8 installer_ui_text_cleanup-2098047-4.patch1.85 KBmgifford
#6 node-content_page_desc-1164700-10-D8.patch675 bytessnehi
#4 installer_ui_text_cleanup-2098047-4.patch1.85 KBalansaviolobo
#3 Drupal installation complete core.png673.39 KBkaja_jacobsen
#3 Configure site Drupal.png976.67 KBkaja_jacobsen
#2 2098047-2.patch2.46 KByoroy
installer-copy-6.png16.05 KByoroy
installer-copy-5.png20.05 KByoroy
installer-copy-4.png31.28 KByoroy
installer-copy-3.png55.32 KByoroy
installer-copy-2.png49.79 KByoroy
installer-copy-1.png78.64 KByoroy
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

yoroy’s picture

yoroy’s picture

Status: Active » Needs review
FileSize
2.46 KB

First stab at things…

kaja_jacobsen’s picture

This is good work. A good idea.
Made me think about the whole 'welcoming proces' - but it is out of scope for this issue - might be an interesting snowman discussion

I have only a few comments in the attached files.

This is actually my first issue queue contribution - so please advice if some of it is out of scope and if there are ways I might work on with it, thanks :).

/K

alansaviolobo’s picture

reroll

ifrik’s picture

Should we still take this up at before RC1 so that also the translations will be better?

If so, then it should be tagged with Barcelona2015

snehi’s picture

Please review the attached patch.

snehi’s picture

Please ignore the last patch.

mgifford’s picture

re-uploading for the bot.

Status: Needs review » Needs work

The last submitted patch, 8: installer_ui_text_cleanup-2098047-4.patch, failed testing.

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

Drupal 8.0.6 was released on April 6 and is the final bugfix release for the Drupal 8.0.x series. Drupal 8.0.x will not receive any further development aside from security fixes. Drupal 8.1.0-rc1 is now available and sites should prepare to update to 8.1.0.

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

yoroy’s picture

Issue tags: +ux-interfacetext
ifrik’s picture

Issue tags: +DevDaysMilan
pguillard’s picture

Status: Needs work » Needs review
FileSize
1.98 KB

Patch #8 rerolled

chetan2111’s picture

FileSize
15.99 KB
42.69 KB
36.34 KB
20.44 KB

Hi @pguillard,

I tested your patch and it works successfully. Here i have attached some screenshots.

pguillard’s picture

Thanks @chetan2111 for your screenshots.

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

Drupal 8.1.9 was released on September 7 and is the final bugfix release for the Drupal 8.1.x series. Drupal 8.1.x will not receive any further development aside from security fixes. Drupal 8.2.0-rc1 is now available and sites should prepare to upgrade to 8.2.0.

Bug reports should be targeted against the 8.2.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.3.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

ifrik’s picture

Issue tags: +sprint, +Barcelona2015
tkoleary’s picture

Issue tags: -DevDaysMilan, -Barcelona2015

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

Drupal 8.2.6 was released on February 1, 2017 and is the final full bugfix release for the Drupal 8.2.x series. Drupal 8.2.x will not receive any further development aside from critical and security fixes. Sites should prepare to update to 8.3.0 on April 5, 2017. (Drupal 8.3.0-alpha1 is available for testing.)

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

Drupal 8.3.6 was released on August 2, 2017 and is the final full bugfix release for the Drupal 8.3.x series. Drupal 8.3.x will not receive any further development aside from critical and security fixes. Sites should prepare to update to 8.4.0 on October 4, 2017. (Drupal 8.4.0-alpha1 is available for testing.)

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

cbeier’s picture

Status: Needs review » Needs work
cbeier’s picture

Version: 8.5.x-dev » 8.6.x-dev
Status: Needs work » Needs review
FileSize
2.06 KB

Patch from #13 re-rolled or 8.6.x.

Unfortunately, an interdiff could not created.

cilefen’s picture

@cbeier It is impossible to interdiff a reroll.

borisson_’s picture

This is a good start, but not all the changes request in #1 are fixed. Should we start by committing this and create a new issue for other improvements?

ifrik’s picture

Status: Needs review » Needs work

Needs reroll

error: patch failed: core/lib/Drupal/Core/Installer/Form/SiteConfigureForm.php:198
error: core/lib/Drupal/Core/Installer/Form/SiteConfigureForm.php: patch does not apply
pguillard’s picture

Assigned: Unassigned » pguillard
pguillard’s picture

Status: Needs work » Needs review
FileSize
1.68 KB

Patch rerolled

pguillard’s picture

Assigned: pguillard » Unassigned
ifrik’s picture

Status: Needs review » Needs work
Issue tags: +DevDaysLisbon

Thanks pguillard,

Most points are addressed, just two small points:

  1. Regional settings: the description text under the Default country widget can be removed (as in yoroy's screenshot) because it doesn't add any additional information
  2. Update notifications: It's a bit unclear what the sending of anonymous information refers to. We could say In the process of checking for updates, anonymous information about your site is sent to Drupal.org.
pguillard’s picture

Status: Needs work » Needs review
FileSize
2.12 KB
1.21 KB

Update with @ifrik suggestions.
I also changed the link to http“s”://drupal.org, recommanded nowadays.
(If there is another need, I'm sitting behind you at ddd.)

Dinesh18’s picture

Here is the patch and interdiff as per the comment @ifrik

ifrik’s picture

Status: Needs review » Reviewed & tested by the community
FileSize
7.3 KB
12.12 KB
16.7 KB
11.8 KB
17.09 KB

Thanks pguillard,
All issues addressed in issue summary are addressed. As already pointed out in the issue description, the description text for the site email address cannot be shortened since it only contains relevant information. Additionally, the link to drupal.org has been changed to https://

Screenshots

ifrik’s picture

Just for clarification: I RTBCed installer_ui_text_cleanup-2098047-31.patch

The other patch in #32 came in while I was doing the review, so I didn't look at that further.

Gábor Hojtsy’s picture

Status: Reviewed & tested by the community » Needs work

"in this site" is not valid English AFAIK, not sure how that sentence ended in the code to begin with. "Also we know that the settings are about this site, we don't say that anywhere else, so that is superfluous. "Dates will be displayed in the chosen timezone" sounds better, so its clear what the timezone is for.

As for the new text of "In the process of checking for updates" we can simply say "When checking for updates" IMHO. "In the process of" makes it sounds like some elaborate thing, which it is, but it is not really relevant :)

Dinesh18’s picture

Status: Needs work » Needs review
FileSize
2.1 KB
1.62 KB

Here is the updated patch and interdiff as per comment #35

ifrik’s picture

Status: Needs review » Needs work

I just double-checked about the help text on the timezone, and it's actually not correct. Depending on the configuration, users can set their own timezones - in which case the date will be displayed to them in their chosen timezone.
Also there is some timezone weirdness, that means the timezone set in the installation is used for the system to convert time into UTC - not necessarily displaying it in that timezone. So I'm told by ekes working on the timezone issue that the current help text is wrong anyway.

Having said that: the help text doesn't add anything that isn't already obvious from the field label, including by saying "default" it already gives an indication that it can be overridden.

So I would propose removing the description altogether.

And a note about naming patches:
Dinesh18: you should always keep the original patch name and only change the number because otherwise reviewers don't know whether something is a new patch starting from scratch or work based on an existing patch. Especially in a case like this, where a second patch was posted on an issue that was already set to be reviewed. Also the interdiff should include the old and new number.
In this case I needed to go back and check manually on which patch you had based your further work. In this case, I knew what to look for, but in other cases that can be much more work.

Dinesh18’s picture

Here is the updated patch and interdiff as per the comment mentioned in #37.
@ifrik, I have followed the proper steps for creating the patch and interdiff this time.
Sorry for the patch which I have created earlier with wrong naming convention.

Dinesh18’s picture

Status: Needs work » Needs review
ifrik’s picture

Status: Needs review » Reviewed & tested by the community

Thanks Dinesh18, and thanks for changing the patch name back again.

The description on the Default time zone widget is now removed, so I think this is ready.

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.

catch’s picture

Status: Reviewed & tested by the community » Fixed

Committed f6e473e and pushed to 8.7.x. Thanks!

  • catch committed f6e473e on 8.7.x
    Issue #2098047 by pguillard, Dinesh18, yoroy, cbeier, ifrik, chetan2111...

Status: Fixed » Closed (fixed)

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