Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update guidance for "go to" #569

Open
daobrien opened this issue Mar 28, 2024 · 7 comments
Open

Update guidance for "go to" #569

daobrien opened this issue Mar 28, 2024 · 7 comments
Labels
impediment Not really a bug but annoying. P2 Should address this soon.

Comments

@daobrien
Copy link
Collaborator

https://stylepedia.net/style/6.2/#n

Includes an entry for "navigate to".

This has been discussed more than once in the past and is now in direct conflict with IBM:

navigate verb
Use only when a more direct verb, such as click, select, browse, or go to, is not applicable. Use only to provide
direction to a location (for example, “Navigate to the directory that contains the files that you want to edit”).

"Go to" is much simpler language and "covers more bases" (sometimes there's no actual navigation involved) and is also suitable when directing readers to other web sites, etc. For everyday purposes, click, select, and browse are more restrictive. So far I haven't encountered a case where "go to" doesn't work, but many cases where one or more of the other options do not work.

https://github.com/RedHatTraining/vale-styles/issues/365 is in place to work on this.

@daobrien daobrien added impediment Not really a bug but annoying. P2 Should address this soon. labels Mar 28, 2024
@julian-cable
Copy link
Collaborator

I would indeed endorse a move away from "navigate to" as the preferred wording in favour of simpler wording such as "go to".

@sffrench @rclee33 Any comments welcomed.

@rclee33
Copy link
Contributor

rclee33 commented Apr 29, 2024

I don't have a strong preference here - the proposed change sounds good to me!

@sffrench
Copy link
Contributor

Sounds like a good change.

@julian-cable
Copy link
Collaborator

Some examples from David:

  • Navigate to File > Save. > - Go to File > Save.
  • Navigate to the Discovery channel. > - Go to the Discovery channel.
  • Open a browser and navigate to http://whatever.com/ > - Open a browser and go to http://whatever.com/
  • Navigate to the student user's home directory. > - Go to the student user's home directory.

@daobrien
Copy link
Collaborator Author

daobrien commented May 7, 2024

As expected (and described at least in part in IBM), there's going to be some
exceptions to this.

I don't have a "ruleset" at this point, but these sorts of things are showing
up:

  1. Click the TabName tab. (Not "Go to...".)
  2. For something like "File > Save", or anything else where that's the end of the
    operation, I would still use "click". In these cases you're not actually
    going anywhere, but rather doing something specific.

I'll add more as I think of them.

@julian-cable
Copy link
Collaborator

I guess it might be a question of something along the following lines:
Where you have used "click" or "select", continue to do so.
Where you previously used "navigate to", now use "go to" instead.

@rclee33
Copy link
Contributor

rclee33 commented Jun 5, 2024

I noticed another section where "navigate to" is documented in the Style Guide. I'm noting it here so that we can update this mention as well when the "go to" guidance is adopted.

Section 3.4.1.1 (under 3.4.1 https://stylepedia.net/style/6.2/#gui-elements-punctuation): "Navigating Through Multiple UI Options".

Screenshot 2024-06-05 at 11 13 38 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
impediment Not really a bug but annoying. P2 Should address this soon.
Projects
None yet
Development

No branches or pull requests

4 participants