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

Commit 4e7f7c6

Browse files
committed
add screenshots and more context to responses
1 parent 75fa9e3 commit 4e7f7c6

10 files changed

Lines changed: 49 additions & 25 deletions

config.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -162,6 +162,10 @@ steps:
162162
title: Congratulations
163163
body: congratulations.md
164164
action_id: congratulationsIssue
165+
data:
166+
learningPathURL: 'https://github-learning-lab-staging.herokuapp.com/githubtraining/paths/innersource:-theory-to-practice'
167+
forkURL: '%payload.repository.html_url%/fork'
168+
downloadURL: '%payload.repository.html_url%/archive/master.zip'
165169
- type: respond
166170
with: goto-pr.md
167171
data:

responses/congratulations.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,15 @@
11
# :tada: Congratulations
22

3-
You are finished with this course. You can see a deployed version of our work together at [LINK]. Feel free to share this link directly with others, or move it to your own organization.
3+
You are finished with this course. You can see a deployed version of our work together at [LINK]. Feel free to share this link directly with others, or you can save the resources in one of the following ways.
44

5-
- If your organization is on GitHub.com, [fork it]().
6-
- If your organization is on GitHub Enterprise Server, [clone and push it]() to your instance.
5+
### Saving course resources
76

8-
Your next steps are in the [Innersource learning path]().
7+
1. If you'd like to just save the contents to your machine, you can:
8+
- Use this shortcut link to [download the files]({{ downloadURL }})
9+
- Manually download the files by clicking on the **Code** tab, clicking on **Clone or download** and clicking **Download ZIP**.
10+
- [Clone the repository](https://help.github.com/en/articles/cloning-a-repository) to your machine.
11+
1. If you'd like to transfer the repository to an organization on GitHub:
12+
- If your organization is on GitHub.com, [fork it]({{ forkURL }}).
13+
- If your organization is on GitHub Enterprise Server, [transfer the repository](https://help.github.com/enterprise/2.2/admin/articles/moving-a-repository-from-github-com-to-github-enterprise)
14+
15+
Your next steps are in the [Innersource learning path]({{ learningPathURL }}).
Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
### Answer :crystal_ball:
22

3-
This repository is actually for ___.
3+
This repository is the source code for https://services.github.com.
44

55
Did you guess it? Probably not, because it doesn't contain many of the necessary elements to make a repository discoverable.
66

@@ -9,4 +9,6 @@ Some suggestions to ensure your teammates can find your repository are:
99
- give your repository a description
1010
- provide a URL for the deployment of the app, or documentation about this project
1111

12+
Discover more about how to make a repository discoverable by visiting the **Files Changed** tab. It's OK if you want to do this later, any resources we cover throughout the course will be available at the end.
13+
1214
Please merge this PR.

responses/discoverable.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,6 @@ This PR is all about how to make your repositories more discoverable.
44

55
What is this repository for?
66

7-
[SCREENSHOT OF BARE REPOSITORY WITHOUT DOCS]
7+
![screenshot of a repository with no description, link, or and just a few folders: .github, .vscode, _appendix, _events, _includes, _layouts](https://user-images.githubusercontent.com/16547949/56039355-2430b380-5d02-11e9-999c-aa139a8146c2.png)
88

99
I'll respond when I detect you've submitted a comment on this PR.

responses/metrics-answer.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,10 @@
22

33
Those are great ideas!
44

5-
Here are some other ideas of measuring how well you're doing:
6-
- IDEAS HERE
5+
Here are some other ideas for measuring how well you're doing:
6+
- Time to market
7+
- PRs to fix bugs
8+
- PRs to implement suggested features
9+
- number of collaborators to a project outside of maintaining team
710

811
I'll respond when you merge this PR.

responses/projects.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,14 @@ This to discuss project management!
22

33
### Challenge question
44

5-
Here's some open issues in this company project. Which one should you work on?
5+
Here's some open issues in this company project. You're eager to help with this project. Which issue should you work on?
66

7-
[SCREENSHOT OF A HANDFUL OF ISSUES]
7+
![screenshot of a repository with 5 open issues, none without labels and all opened by @githubteacher. The issues are: restyle the slides, improve the readme, add a caption to an existing slide, add a new slide, activity 1: your first caption](https://user-images.githubusercontent.com/16547949/56040343-30b60b80-5d04-11e9-90c7-58e9791b8ebf.png)
88

9-
- [ ] issue 1
10-
- [ ] issue 2
11-
- [ ] issue 3
12-
- [ ] issue 4
9+
- [ ] Issue 6: Restyle the slides
10+
- [ ] Issue 5: Improve the README
11+
- [ ] Issue 4: Add a caption to an existing slide
12+
- [ ] Issue 3: Add a new slide
13+
- [ ] Issue 2: Activity 1: Your first caption
1314

1415
I'll respond when you check one of the boxes above.

responses/repo-owner-answer.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,18 @@
11
### Answer :crystal_ball:
22

3-
A repository _does_ exist at githubtraining/training-manual.
3+
A repository _does_ exist at githubtraining/training-manual, but it is private.
4+
5+
![screenshot of repository, pointing to ownership by githubtraining organization, and to a private visibility](https://user-images.githubusercontent.com/16547949/56038959-31996e00-5d01-11e9-8a08-5dadb0f026ce.png)
46

57
<details>
6-
<summary>Why can't you see it then? Review the **Files Changed** tab and see if you can figure it out. Collapse this text if you'd like an explanation.</summary>
8+
<summary>Why can't you see it then? Review the <b>Files Changed</b> tab and see if you can figure it out. Collapse this text if you'd like an explanation.</summary>
79

810
The repository `training-manual` in the @githubtraining organization is private, and only visible to memebers of that organization. If you're not a member of the organization, it'll appear like the repository doesn't exist to you. This is an example of why having the right ownership structure is important. Having too many organizations with restrictive permissions means that each organization's work will be siloed.
911
</summary>
1012

1113
Here are some recommendations based on some :sparkles: use of GitHub that we've seen:
1214
- aim for as few organizations as possible, remember: each organization is a black box to those outside of that organization
1315
- name your repositories in a meaningful manner, usually a simple project or application name will suffice
16+
</summary>
1417

1518
Please merge this PR.

responses/repo-owner.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This pull request is all about repository ownership and naming conventions.
44

55
Does a repository exist at https://github.com/githubtraining/training-manual?
66

7-
- [ ] True, there is at the given URL.
7+
- [ ] True, there is a repository at the given URL.
88
- [ ] False, no repository exists at the given URL.
99

1010
I'll respond when I detect you've checked one of the boxes above.

responses/templates.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ Let's now learn about issue and pull request templates.
44

55
Here are four different ways you could submit a bug report. Which is the _right_ way?
66

7-
- [ ] [SCREENSHOT 1]
8-
- [ ] [SCREENSHOT 2]
9-
- [ ] [SCREENSHOT 3]
10-
- [ ] [SCREENSHOT 4]
7+
- [ ] Open an issue on GitHub
8+
- [ ] Create a Jira issue
9+
- [ ] Open an internal support ticket
10+
- [ ] DM or email the maintainer
1111

1212
I'll respond when you check one of the boxes above.

responses/workflows.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,14 @@ This PR covers a few common workflow that are likely in use within your organiza
22

33
### Challenge question
44

5-
I'd like to contribute to this repository. Which branch should I target my changes for?
5+
Suppose you'd like to contribute to the repository whose branches are pictured below. Which branch should I use as a base for my contributions?
6+
7+
![a screenshot of a repository's branches, they are: a protected master branch, a protected release-v1.0 branch. The rest are unprotected: bug-fix, green-colors, config-release-drafter, add-template](https://user-images.githubusercontent.com/16547949/56039935-5d1d5800-5d03-11e9-8a26-29d36cfc7499.png)
8+
69
- [ ] `master`
7-
- [ ] `release-candidate`
8-
- [ ] `dev`
9-
- [ ] Don't know
10+
- [ ] `release-v1.0`
11+
- [ ] `bug-fix`
12+
- [ ] `green-colors`
13+
- [ ] `config-release-drafter`
1014

1115
I'll respond when I detect you've checked one of the boxes above.

0 commit comments

Comments
 (0)