Improve the microcopy on the settings page

Created on 28 March 2025, 5 months ago

Problem/Motivation

For the initial commit I've oriented mostly to the microcopy provided on https://skipto-landmarks-headings.github.io/page-script-5/config.html, but there are also examples like "Example Number Field", the label for the horizontal position of the SkipTo button, i am not really sure about how that went in and why i ended up with something like that, it is completely wrong and misleading.

Steps to reproduce

Proposed resolution

With a bit of a distance, after creating 📌 Port to Drupal 9 Active , reevaluate and come up with better, clearer, and more consistent microcopy. Ideally consider providing/suggesting those improvements upstream afterwards as well

Remaining tasks

User interface changes

API changes

Data model changes

🐛 Bug report
Status

Active

Version

2.0

Component

User interface

Created by

🇩🇪Germany rkoller Nürnberg, Germany

Live updates comments and jobs are added and updated live.
  • Usability

    Makes Drupal easier to use. Preferred over UX, D7UX, etc.

  • Accessibility

    It affects the ability of people with disabilities or special needs (such as blindness or color-blindness) to use Drupal.

Sign in to follow issues

Merge Requests

Comments & Activities

  • Issue created by @rkoller
  • 🇩🇪Germany rkoller Nürnberg, Germany

    i've assigned the issue to myself and already created a MR.. Will work on an initial draft the next few days...

  • Assigned to rkoller
  • 🇩🇪Germany rkoller Nürnberg, Germany

    rkoller changed the visibility of the branch 3516073-improve-the-microcopy to hidden.

  • Pipeline finished with Failed
    16 days ago
    Total: 139s
    #572525
  • 🇩🇪Germany rkoller Nürnberg, Germany

    ok MR9 is ready to review. had to hide MR6 cuz turned out previous changes prevented a rebase and fixing it locally was above my skill level so i did a fresh start and created MR9. Changes I did:

    • changed the label for the setting page from skipto which might be too abstract for someone who has not installed the module nor has access to the extend page. instead of using the module name i went with Skip links, the thing the module is about.
    • i've then dropped the dedicated color theme, labels and restore settings pages so there is only a single settings page left. for the color themes i'Ve dropped the option to override the hex values and moved the select to the single skipto settings page. the option to override the labels i've dropped for now. it does not make any sense to provide that level of granularity. only downside i am not sure how translations should be handled with strings not available as form elements? and the option to restore the default settings is sort of unnecessary as soon as the option for altering the labels was removed. there is no danger that the user ends up with a broken setup.
    • and i've updated the help page as well.
  • 🇩🇪Germany rkoller Nürnberg, Germany

    and added units to the description for the font size. an important detail, so far i've only added a numeric number and wondered why the font size got smaller even though a value of > 50 was entered. the number needs a unit like pixel or em then everything is working as expected.

  • Pipeline finished with Failed
    15 days ago
    Total: 127s
    #573341
  • Pipeline finished with Failed
    11 days ago
    Total: 168s
    #576013
  • 🇩🇪Germany rkoller Nürnberg, Germany

    pushed some changes based on the discussion with @mgifford today. the options on the "Scroll to target" select are not perfect. two options are identical to skipto upstream (fixed and popup-border), and two are more descriptive and verbose (static on top, visible on focus); fixed is ok but popup-border is still abstract and not self explanatory and clear.

  • 🇬🇧United Kingdom the_g_bomb

    Module and patch installs cleanly. I agree with the simplification of the module to remove some of the settings.

    The module works well functionally, but I have made some comments on the renaming of the Settings etc, I think we should keep the term "SkipTo menu" rather than introducing "Skip links menu". Open to discussion, however.

  • Pipeline finished with Failed
    9 days ago
    Total: 171s
    #577914
  • 🇬🇧United Kingdom the_g_bomb

    Merged, we can fix any other issues in the follow-up issues.

  • 🇬🇧United Kingdom the_g_bomb
  • 🇬🇧United Kingdom the_g_bomb

    It seems the merge train failed

  • 🇬🇧United Kingdom the_g_bomb

    Merge train finished successfully

Production build 0.71.5 2024