Explain how to install the app

[jms1voalte]

Problem Description

• In this repo's README.md file, under "Usage", item 1 is "Install the app", with a link to https://github.com/apps/settings

• On that page, under "Usage", is the same item 1, with the same link to https://github.com/apps/settings ... clicking that link looking for directions on how to install the app just takes you to the same page you're already on.

If there is a separate page explaining how to install the app, shouldn't these links point there instead of just pointing to the same page over and over again?

What is actually happening

Links point to the same page that the link itself is on, without any details about how to "install" the app.

What is the expected behavior

Links should point to a page which explains how to "install" the app.

[electriquo]

I think that Installing GitHub Apps is what you are after

[jms1voalte]

That's possible ... and if so, why doesn't the README.md file contain a link to THAT page? Having a link that says "Install the app", WHICH POINTS TO THE SAME PAGE, is rather pointless, no?

[electriquo]

The ProBot Settings app on GitHub Apps is using the README.md of the project. You should look at the green button on the right side that says "install".

[jms1voalte]

There is no green button that says "install" if you're not logged into a GitHub account.

In my case, I'm using Safari in "private mode", which means that the session cookies which make me "logged in" on one tab, don't carry over to new tabs. Once I logged in in the second tab I was able to see big green button, and things started to make sense.

So maybe it would make sense to add something which tells the user to log into their account if they don't see the big green button? (And included the link you provided, to a "how to install GitHub Apps in general" page, as well. That would be helpful to people like me for whom this is their first exposure to GitHub Apps.)

[electriquo]

@jms1voalte You are not signed-in to GitHub. Once you do, the green "install" button will appear.

[patcon]

@foolioo Agreed. @jms1voalte you should probably not expect to be finding a tailored install flow for an extension when you're not logged in. This feels quite niche, as the vast majority of people travelling this path will be logged in.

Having said that, speaking as a passerby here, I'm sure if you felt like submitting a small change to the repo to tip off someone like yourself in the future, the future person like yourself would be appreciative ❤️

[patcon]

Actually, just added it here, since it seems it's such a small fix that would make it clearer 🙏
#573