Skip to content

Someone's real username is being used as an example #42795

@CourteousCoder

Description

@CourteousCoder

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:

  1. Appointing an organization owner
  2. Removing a member from your organization manually
  3. 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 screenshot in question

The Problem

  • The username jsmith belongs 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:
    • ✔️ The Octocat: octocat - a dedicated example user whose display name is "The Octocat"
    • ✔️ Hubot: hubot - a dedicated example user whose display name is "Hubot"
    • ❌ John Smith: jsmith - a real user whose display name is not "John Smith"
  • 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 😅)

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamtriageDo not begin working on this issue until triaged by the team

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions