Introduction to GH Apps Outline

[a-a-ron]

@hollenberry I still need to run a second pass over it but I wanted to push this up so you could review and make any needed adjustments. For reference see #3

@hectorsector I'd love to get your 👀 on this as well

For the Probot App installs, we decided on the two below:

1) WIP 2) Reminders

Items that I would love review

The first several steps present content and then conclude when the user closes the issue. I'm thinking we may want to combine some of these to reduce the amount of open/close issues before the user performs a task?

[a-a-ron]

Or does this feel too "quizzy", as we chatted about during our sync?

@hollenberry I don't think it would feel too "quizzy" if we prompted the user to guess the webhook events and then regardless of their answer we continued with the course. If they answered correct, we'd respond back with a "congratulations" or something similar and then proceed to the next content. If they answered incorrectly, we'd just respond with a "great guess, but it's actually..." or something similar and then proceed with the next content. I think it would feel quizzy if we had them retry until correct.

[a-a-ron]

I agree with your sentiment and think that Steps 1 - 4 can likely be condensed into one issue. Maybe we can think of an organic activity that breaks the 4 subsections up into 2 or 3 comments?

@hollenberry I agree. The only reason I split these steps up was to help add user engagement throughout this content instead of having one issue with a lot of drop-downs but maybe that's the best way to present this information.

Perhaps we do one of the following:

• have the user assign the issue to themselves to initiate a bot response with some of this content. This keeps the same issue but includes some user interaction
• have the user comment below with "next" or something similar to initiate the next bot response in the same issue

[hollenberry]

• have the user comment below with "next" or something similar to initiate the next bot response in the same issue

If we want to be real cheeky we can ask them to comment with their favorite "App", and we can tell them that "we were hoping you'd say Learning Lab. We'll remember this when robots gain sentience."

[a-a-ron]

Thanks @hollenberry for your ✨ verbose. I think your' should be the source-of-truth so i'll remove my outline unless you think it's worth keeping.