Creating a New Lesson (by Eric Lease Morgan)

[zkamvar]

NOTE: This is a friction log sent to @zkamvar on The Carpentries slack. I am posting this here with permission.

I created a lesson, and here's how:

library("fs")
library("sandpaper")
rl <- path_home("Desktop/reader-lessons")
create_lesson(rl)
sandpaper::serve()

At this point a local HTTP server fired up, and my browser opened the plain vanilla set of lessons. 'Worked great!

I then:

usethis::use_github()
usethis::use_github_pages()

A GitHub repository was created, and after waiting patiently magic happened. More specifically, GitHub created a website for me at https://ericleasemorgan.github.io/reader-lessons/ Again, worked great.

I will now try to trivially edit an episode, view the changes locally, commit the changes to GitHub, and view the changes on the Web.

Hmmm... I want to edit the files on my local machine, not necessarily GitHub. I can make an edit, such as editing the file named introduction.Rmd, but how to I "compile" the whole thing to see the changes locally?

Oh my gosh! I can answer my own question. "Edit file. Wait a tiny bit. A robot will see the changes, and my work will be rendered locally."

I will now see about committing the changes to GitHub. Hmmm...

From the command line, committing the changes was seamless:

git status
git add .
git commit -m
git push

More magic happened. After committing GitHub redeployed my site, and the changes were visible. In short, it all worked pretty well.