Issue #3485092 by kopeboy: Improved wording and additional tips

config/tour.tour.block_layout.yml

@@ -16,31 +16,47 @@ tips:
     id: block_layout
     plugin: text
     label: 'Block Layout'
-    weight: 1
-    position: 'auto'
+    weight: -100
+    position: auto
     selector: null
-    body: 'Blocks are boxes of content rendered into an area, or region, of a web page that can be displayed in regions (such as footer or sidebar) on your page.'
+    body: 'Blocks are boxes of content that can be displayed in regions (such as footer or sidebar) of your pages.'
+  regions_of_a_theme:
+    id: regions_of_a_theme
+    plugin: text
+    label: 'A Layout per Theme'
+    weight: -99
+    position: auto
+    selector: .tabs__link.is-active
+    body: 'Each theme defines its available regions and will have its block layout.'
   place_block:
     id: place_block
     plugin: text
     label: 'Place Blocks'
     weight: 2
     position: 'auto'
-    selector: .button--small
-    body: 'Any custom or contributed block can be added to a particular region by clicking on a button Place block. A new block can also be created by clicking on Place Block'
+    selector: '#edit-blocks-region-header-title a'
+    body: 'Add a block to a region with this button: you'll see the full library of contributed and custom blocks, and a button to create a new one.'
   block_region:
     id: block_region
     plugin: text
-    label: 'Block Region'
+    label: 'Select Region'
     weight: 3
     position: 'auto'
     selector: .block-region-select
-    body: 'Assign or change the region of a block by clicking here. A dropdown list with all the regions will appear. You can place one block in multiple regions.'
+    body: 'You can quickly change the region of a block with this dropdown list...'
+  place_block_by_drag_drop:
+    id: place_block_by_drag_drop
+    plugin: text
+    label: 'Drag into Region'
+    weight: 4
+    position: 'auto'
+    selector: .tabledrag-handle
+    body: '... or by dragging the block row into the desired region. Remember to save your changes!'
   configure_block:
     id: configure_block
     plugin: text
     label: 'Configure Block'
-    weight: 4
+    weight: 5
     position: 'auto'
     selector: .dropbutton-widget
-    body: 'By Clicking on "Configure" you can go ahead and edit the contents of the block, deal with the visibility settings and even change the placement of where it is on your theme.'
+    body: 'From here you can adjust any options the block might have and set its visibility conditions (show it only to some user roles, on certain pages, etc.). Use the dropdown menu to quickly disable or remove it, or, depending on the block type, edit its content.'

config/tour.tour.custom_blocks_list.yml

@@ -17,7 +17,7 @@ tips:
     weight: 1
     position: 'auto'
     selector: null
-    body: 'Custom block are used to create content that can be displayed in block regions such as sidebars.'
+    body: 'Custom blocks are used to create content that can be displayed in block regions (such as sidebars, footer, etc.) on multiple pages.'
   blocks_and_types:
     id: blocks_and_types
     plugin: text
@@ -37,8 +37,8 @@ tips:
   edit_button:
     id: edit_button
     plugin: text
-    label: 'Edit button'
+    label: 'Operation links'
     weight: 4
     position: 'auto'
     selector: .dropbutton-widget
-    body: 'By click on dropdown, you will find edit option, can edit block content and how it is displayed via the dropdown links.'
+    body: 'With this button and the dropdown options you can manage the block fields, its displays (formatting options), user permissions and general settings.'

config/tour.tour.dblog.yml

@@ -17,15 +17,15 @@ tips:
     weight: 1
     position: top-start
     selector: null
-    body: "System events such as errors, failed login attempts and content updates are stored as messages in the site's database. On the <em>Recent log messages</em> page you find a chronological list of recorded messages that you can filter and view. You should check the log messages on a regular basis to ensure the site is working properly"
+    body: 'System events such as errors, failed login attempts and content updates are stored as messages in the site's database. Here you have a chronological list of recorded messages that you can filter and order. You should check the log messages on a regular basis to ensure the site is working properly.'
   dblog_filter_clear:
     id: dblog_filter_clear
     plugin: text
     label: 'Clearing messages'
     weight: 2
-    position: 'auto'
-    selector: null
-    body: 'Click on the <em>Delete</em> tab on the top left to delete all the log messages from the database.'
+    position: auto
+    selector: '.tabs a[href='/admin/reports/dblog/confirm']'
+    body: 'Click on the <em>Delete</em> tab to delete all the log messages from the database (upon confirmation), reduce its size and start clean.'
   dblog_filter:
     id: dblog_filter
     plugin: text
@@ -48,8 +48,8 @@ tips:
     label: 'Recognizing messages'
     weight: 5
     position: 'auto'
-    selector: null
-    body: 'The severity of the message is made visible with colors and icons.'
+    selector: 'tbody tr'
+    body: 'The severity of the message will also be made visible with colors and icons in each row.'
   dblog_table_view:
     id: dblog_table_view
     plugin: text
@@ -65,4 +65,4 @@ tips:
     weight: 99
     position: 'auto'
     selector: null
-    body: 'For more information, see [help.page.dblog]<a href="https://www.drupal.org/documentation/modules/dblog">the online documentation</a>. On the <a href="[site:url]admin/config/development/logging">configuration</a> page you define which and how many messages should be stored.'
+    body: 'On the <a href='/admin/config/development/logging'>Logging and errors configuration page</a> you can define how many log messages should be kept (automatically deleting older ones). For more information, see <a href='/admin/help/dblog'>the help page</a> or <a href='https://www.drupal.org/documentation/modules/dblog'>the online documentation</a>.'

config/tour.tour.field_ui_display.yml

@@ -17,7 +17,7 @@ tips:
     weight: 1
     position: 'auto'
     selector: null
-    body: 'Manage how the content type fields are displayed on your site.'
+    body: 'Manage how the fields of this content type are displayed on your site.'
   display_modes:
     id: display_modes
     plugin: text
@@ -25,23 +25,23 @@ tips:
     weight: 2
     position: 'auto'
     selector: .tabs--secondary
-    body: 'Display modes allow content to be output in different ways. E.g., Default display shows all fields, but Teaser display shows only one or two.'
+    body: 'Display modes allow the same piece of content to be output in different ways. For example, the <b>Default</b> display shows all fields, while the <b>Teaser</b> only one or two. You will be able to choose whenever listing, referencing, or embedding content.'
   label:
     id: label
     plugin: text
-    label: 'Field label'
+    label: 'Label'
     weight: 3
     position: 'auto'
-    selector: '#field-display-overview > thead > tr > th:first-child'
-    body: 'Field labels can be positioned above, inline or hidden.'
+    selector: '#field-display-overview > thead > tr > th:nth-child(5)'
+    body: 'Each field <strong>Label</strong> can be positioned above, inline or hidden. Choose the "Visually hidden" option if you care about accessibility: it will hide the label but leave it in the HTML for screen readers.'
   format:
     id: format
     plugin: text
     label: Format
     weight: 4
     position: 'auto'
-    selector: '#field-display-overview > thead > tr > th:nth-child(7)'
-    body: 'Formats are used to display field information in different ways, e.g., tags can be displayed in plain text or link form.'
+    selector: '#field-display-overview > thead > tr > th:nth-child(6)'
+    body: 'Formats are used to display field information in different ways. Some formats can be customized by clicking on the cog icon at end of the row. Contributed and (your own) custom modules can extend each field type by providing new formatters and settings.'
   custom_display_settings:
     id: custom_display_settings
     plugin: text

config/tour.tour.field_ui_form_display.yml

@@ -17,12 +17,44 @@ tips:
     weight: 1
     position: 'auto'
     selector: null
-    body: 'Manage how the field forms are displayed when editing content by reordering fields or changing the widget settings.'
+    body: 'Manage how the fields are displayed in forms (when adding or editing content) by reordering them or changing their widget settings.'
+  field_widget:
+    id: field_widget
+    plugin: text
+    label: 'Field Widget'
+    weight: 2
+    position: 'bottom-start'
+    selector: '.field-plugin-type'
+    body: 'Each field type has one or more widgets to customize its input method. Any contributed or (your own) custom module can define new widgets.'
+  widget_settings:
+    id: widget_settings
+    plugin: text
+    label: 'Widget Settings'
+    weight: 3
+    position: 'bottom'
+    selector: '.field-plugin-summary-cell'
+    body: 'Some widgets are configurable. Here you can see the summary of the current widget settings. Use the cog icon on the side to change them.'
   widget:
     id: widget
     plugin: text
-    label: Widget
-    weight: 2
+    label: 'Show/Hide Fields'
+    weight: 4
+    position: 'auto'
+    selector: 'tbody tr:last-child'
+    body: 'To show or hide a field, drag & drop it above or below the <b>Disabled</b> section.'
+  show_row_weights:
+    id: show_row_weights
+    plugin: text
+    label: 'Show/Hide Row weights'
+    weight: 5
+    position: 'auto'
+    selector: '.tabledrag-toggle-weight'
+    body: 'Especially with many fields, it may become easier to reorder or hide them by first clicking this button. This will toggle between the draggable handles and the <b>Weight</b>, <b>Parent</b>, and <b>Region</b> inputs for each row. Try it now!'
+  save_changes:
+    id: save_changes
+    plugin: text
+    label: 'Save Changes'
+    weight: 6
     position: 'auto'
-    selector: 'table.field-ui-overview > tbody > tr.tabledrag-leaf'
-    body: 'To show or hide the field choose drag dropdown icon.'
+    selector: '#edit-actions'
+    body: 'Remember to save changes to all your fields (their ordering, widget selection and settings).'