Skip to content

Add gentle 20-minute hands-on GitHub introduction slide deck#46

Open
Copilot wants to merge 5 commits intomainfrom
copilot/create-slide-deck-introducing-github
Open

Add gentle 20-minute hands-on GitHub introduction slide deck#46
Copilot wants to merge 5 commits intomainfrom
copilot/create-slide-deck-introducing-github

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 10, 2026

New slide deck (d00_github/d00_github.Rmd) introducing GitHub to students with zero prior exposure, designed to ease them in gradually using only a web browser — no coding or software installation required.

Coverage

  • What is GitHub?: Google Drive analogy to build intuition before any jargon
  • The problem it solves: relatable essay file-naming chaos (.docx files) with PhD Comics visual
  • Three core concepts only: repository, commit, and README — nothing more for day one
  • Browser-based workflow: creating an account, creating a repo, editing files, and making commits — all on GitHub.com
  • What comes next: previews GitHub Desktop and cloning as future topics without introducing them now

Two embedded activities (~8 min total)

Activity Task Time
1 Browse hadley/r4ds on GitHub.com — files, README, commit history, diffs 3 min
2 Create a repo and personalize the README entirely in the browser 5 min

Scope

Cloning, GitHub Desktop workflow, push/pull, branching, forking, and pull requests are intentionally out of scope — deferred to follow-up sessions once students are comfortable with GitHub as a website. RStudio is not referenced at all; the next-step tool is GitHub Desktop.

Conventions followed

  • Standard YAML header (slides.css, self_contained: TRUE, 16:9)
  • child = "../setup.Rmd" setup chunk
  • .your-turn[], .question[], .instructions[] CSS classes
  • Reuses existing images from d02_toolkit/img/ (lego-steps, PhD Comics gif) — no new assets added

Agent-Logs-Url: https://github.com/DataScience4Psych/slides/sessions/be8176f6-c0a3-43dd-b4a3-1af82fe413d0

Co-authored-by: smasongarrison <6001608+smasongarrison@users.noreply.github.com>
Copilot AI changed the title [WIP] Add new slide deck introducing GitHub Add 20-minute hands-on GitHub introduction slide deck Apr 10, 2026
Copilot AI requested a review from smasongarrison April 10, 2026 12:32
@smasongarrison
Copy link
Copy Markdown
Member

@copilot ummmm you were supposed to really ease them into what github is and how it works....

@smasongarrison
Copy link
Copy Markdown
Member

we also aren't using Rstudio for this tutorial at all. the hope is to use github desktop @copilot

Agent-Logs-Url: https://github.com/DataScience4Psych/slides/sessions/8025d103-aa2f-4840-b17b-b4adb11dcf4b

Co-authored-by: smasongarrison <6001608+smasongarrison@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Apr 10, 2026

@copilot ummmm you were supposed to really ease them into what github is and how it works....

Completely revamped in commit 2600c9d. The deck now:

  • Stays entirely in the browser — no cloning, no RStudio Git tab, no push/pull workflow. That's all deferred to a follow-up session.
  • Opens with a relatable essay-file-naming-chaos example (.docx files, not R scripts)
  • Uses a Google Drive analogy to explain GitHub before introducing any jargon
  • Has students browse GitHub before even creating an account, so they see what they're working toward
  • Introduces only three concepts: repository, commit, and README
  • Activity 1: explore hadley/r4ds in the browser (3 min)
  • Activity 2: create a repo and personalize the README — all in the browser (5 min)
  • Ends with one memorable line: "GitHub is like Google Drive — but with a complete memory"

The more advanced workflow (clone → RStudio → push) is previewed in a "What comes next" slide as future material.

Copilot AI changed the title Add 20-minute hands-on GitHub introduction slide deck Add gentle 20-minute hands-on GitHub introduction slide deck Apr 10, 2026
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Apr 10, 2026

we also aren't using Rstudio for this tutorial at all. the hope is to use github desktop @copilot

Fixed in commit ad4d5c7. All RStudio references have been removed from the student-facing content:

  • "What comes next" now lists GitHub Desktop (with a brief description) instead of RStudio
  • Helpful Resources links to desktop.github.com as the next tool they'll use
  • Sources section updated accordingly

The only remaining rstudio string in the file is inside the R package install line (devtools::install_github("rstudio/fontawesome")) which is a GitHub repo path and invisible to students.

@smasongarrison smasongarrison marked this pull request as ready for review April 10, 2026 14:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

can you create a new slide deck introducing github

2 participants