Skip to content

Improve Screenshots in "Creating a GitHub App" Page #16539

@sarina

Description

@sarina

Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/developers/apps/building-github-apps/creating-a-github-app

What part(s) of the article would you like to see updated?

Problem

On this page, we are looking to find the "GitHub Apps" option in the left sidebar. Step 2 does indeed say to click on "Developer Settings", but it's easy to miss - I've missed that on three separate occasions and now someone on my team just did, so I think it needs to be better called out. Why is this a problem? Currently, there is a GitHub Apps link on the left sidebar as a first class member, and it looks very similar to the screenshot in Step 3.

Instructions the document provides:

image

The "incorrect" GitHub Apps sidebar option that we accidentally click on:

image

Proposed Solution

I suggest Step 2 have the following screenshot:

image

and Step 3 is updated to what you actually see:

image

This will prevent confusion of people like me!!

Additional information

I would be happy to fix this but I suspect you have some standards around images that my screenshots may not be enough.

Metadata

Metadata

Assignees

Labels

contentThis issue or pull request belongs to the Docs Content teamdevelopersContent related to developerswaiting for reviewIssue/PR is waiting for a writer's review

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions