-
Notifications
You must be signed in to change notification settings - Fork 65.9k
Description
Code of Conduct
- I have read and agree to the GitHub Docs project's Code of Conduct
What article on docs.github.com is affected?
This screenshot is used in three different articles to show how to select from a list of members in a GitHub organization for performing a bulk action on multiple users:
- Appointing an organization owner
- Removing a member from your organization manually
- Converting an organization member to an outside collaborator
What part(s) of the article would you like to see updated?
In the screenshot in question, one of the example members is The Octocat (octocat), and the other is John Smith (jsmith):
The Problem
- The username
jsmithbelongs to a real, active GitHub user who, as of this writing, has the display name "Jacob" - Although "John Smith" is clearly just an example name, it is inconsistent with the other example users who have dedicated GitHub profiles which clearly indicate that they exist for demonstration purposes:
- Technically, it would be more accurate to use
jsmith's actual display name (with their permission) instead of John Smith
Potential Solutions
Option A: (best for longevity) Use another dedicated demonstration account instead of jsmith
Consider picking another fictional character owned by GitHub (other than the Octocat or Hubot) and creating a user profile for it. I'd recommend avoiding any GitHub services that act as users (e.g. GitHub Co-Pilot) because that might cause confusion in this context. Perhaps you can create an example account for this "John Smith" e.g. john-example-smith (which is currently not associated with a GitHub user account)
Option B: (least invasive): Blur out the username jsmith in the screenshot
Obscuring the username does not detract from the helpfulness of the screenshot in context because the focus is on the fact that you can check off multiple users in a list rather than on looking up a user by username.
Option C: (no content changes) Ask jsmith if they are okay with their username being in the guides as-is.
If jsmith is okay with referencing their username like this, then I don't see the harm in keeping things as they are.
Additional information
I know this is a bit pedantic and not a big deal if the content stays the same, but I thought I might as well create the issue and see what the community thinks.
(Also, I apologize if I sound like a robot... I've been prompt engineering quite a bit lately to keep up with trends, and I think I've unconsciously adopted that stereotypical AI writing-style, to the point that now my genuine writing is full of emojis and markdown and whatnot 😅)
