Skip to content
This repository was archived by the owner on Sep 1, 2022. It is now read-only.

Prepare course for release #3

Merged
merged 45 commits into from
Apr 7, 2020
Merged

Prepare course for release #3

merged 45 commits into from
Apr 7, 2020

Conversation

mattdavis0351
Copy link
Contributor

This PR addresses the release checklist for this course. The current progress can be found in the tracking issue.

@github-learning-lab
Copy link

Your draft course version was created!


You can edit it using the Course Builder UI!

@github-learning-lab github-learning-lab bot had a problem deploying to production March 25, 2020 21:06 Failure
@github-learning-lab
Copy link

🔴 16 errors found in the config file.

- Action [2] in [GitHub Actions: Using GitHub Script] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[0].link" does not match any of the allowed types
- Action [5] in [Setup a workflow file] does not match the `createReview` action's schema
  - "store" is not allowed
- "steps[1].link" does not match any of the allowed types
- Action [triggerIssue] in [Merge the new workflow into the master branch] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[2].link" does not match any of the allowed types
- "steps[3].link" does not match any of the allowed types
- Action [5] in [Modify your workflow file] does not match the `createReview` action's schema
  - "store" is not allowed
- "steps[4].link" does not match any of the allowed types
- Action [triggerIssue] in [Merge the new workflow into the master branch] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[5].link" does not match any of the allowed types

@github-learning-lab github-learning-lab bot had a problem deploying to production March 25, 2020 21:13 Failure
@github-learning-lab
Copy link

🔴 16 errors found in the config file.

- Action [2] in [GitHub Actions: Using GitHub Script] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[0].link" does not match any of the allowed types
- Action [5] in [Setup a workflow file] does not match the `createReview` action's schema
  - "store" is not allowed
- "steps[1].link" does not match any of the allowed types
- Action [triggerIssue] in [Merge the new workflow into the master branch] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[2].link" does not match any of the allowed types
- "steps[3].link" does not match any of the allowed types
- Action [5] in [Modify your workflow file] does not match the `createReview` action's schema
  - "store" is not allowed
- "steps[4].link" does not match any of the allowed types
- Action [triggerIssue] in [Merge the new workflow into the master branch] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[5].link" does not match any of the allowed types

@github-learning-lab github-learning-lab bot had a problem deploying to production March 25, 2020 21:16 Failure
@github-learning-lab
Copy link

🔴 16 errors found in the config file.

- Action [2] in [GitHub Actions: Using GitHub Script] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[0].link" does not match any of the allowed types
- Action [5] in [Setup a workflow file] does not match the `createReview` action's schema
  - "store" is not allowed
- "steps[1].link" does not match any of the allowed types
- Action [triggerIssue] in [Merge the new workflow into the master branch] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[2].link" does not match any of the allowed types
- "steps[3].link" does not match any of the allowed types
- Action [5] in [Modify your workflow file] does not match the `createReview` action's schema
  - "store" is not allowed
- "steps[4].link" does not match any of the allowed types
- Action [triggerIssue] in [Merge the new workflow into the master branch] does not match the `createIssue` action's schema
  - "store" is not allowed
- "steps[5].link" does not match any of the allowed types

@github-learning-lab github-learning-lab bot had a problem deploying to production March 25, 2020 23:45 Failure
@github-learning-lab
Copy link

🔴 1 errors found in the config file.

- "steps[5].link" does not match any of the allowed types

@github-learning-lab github-learning-lab bot had a problem deploying to production March 25, 2020 23:47 Failure
@github-learning-lab
Copy link

🔴 1 errors found in the config file.

- "steps[5].link" does not match any of the allowed types

@brianamarie
Copy link
Contributor

I'm going through this course for the 2nd time with an eye on the flow with the bot activating the triggers for the actions. It didn't stand out to me before, but I do think there's a chance to reduce confusion here. If I'm understanding correctly, I see the pros/cons as:

The bot opening the issue

  • 👍One less step for the learner to complete
  • 👍All learner actions are about writing code
  • 👎We are assuming that the learner can differentiate between bot activity and action-triggered activity (This is a big one to me - there is a lot of mystery behind Learning Lab, and I think it's a risk to let users confuse the Learning Lab things and the Action things. We can't validate their understanding any other way.)

The Learner opening the issue

  • 👍Learner has to mentally connect the dots that the action is triggered by them opening an issue, or commenting, or whatever was specified in the workflow

I don't see the learner opening issues as a practice in opening issues for no reason - I see it as solidifying the understanding of the workflow that we've asked them to build.

All that said, it didn't occur to me when I went through the course for the first time. Just my two cents 💰

@mattdavis0351
Copy link
Contributor Author

@brianamarie imagine a real world project. I set up the workflow for that repo, and that workflow responds to issues when they are opened by the community. Once I did that I would have to wait for people to open issues themselves, aside from the ones that I may or may not open to track things.

By having the bot open the issue, I feel as though it simulates a more accurate representation of this workflow in the wild. The bot essentially becomes a community member that has stumbled on your repo and opened an issue for whatever reason.

I worry that if the learner is the one who triggers this workflow then we lose that simulation. We could also run the risk of the learner assuming this workflow is tied to them opening issues, and not anyone in the world. That risk is small, but if I'm super new to GitHub and collaboration this is a potential misconception.

Taking the simulated aspect into account, does that change your feedback in anyway?

@brianamarie
Copy link
Contributor

@mattdavis0351 I completely see what you mean. My reasoning is that while simulating the environment is important, it may lose value as a training exercise if it's so realistic that we sacrifice the scaffolding that creates a positive learning experience.

As a possible compromise, what if we had the user trigger the first several instances to solidify the knowledge, then show it as another collaborator later in the course?

@hectorsector
Copy link
Member

@mattdavis0351 I added some validations that I think will help!

Copy link
Member

@hectorsector hectorsector left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mattdavis0351 once we merge this branch I'll get our team testing. We can open new PRs so it isn't the end!

@hectorsector
Copy link
Member

@mattdavis0351 based on our conversations over Slack, I'm going to merge this so I can get this course QA'd.

@hectorsector hectorsector merged commit 3396a67 into master Apr 7, 2020
@hectorsector hectorsector deleted the release-prep branch April 7, 2020 12:41
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy