TeamBasedInquiryLearning / linear-algebra

Materials for running a Team-Based Inquiry Learning linear algebra course
http://linear.tbil.org
Other
10 stars 12 forks source link

Add warmup/cooldown to EV1 #368

Closed StevenClontz closed 2 months ago

StevenClontz commented 2 months ago

Today @jkostiuk and I set up this proof of concept that he wanted to do on a fork of the book, but I thought it might be a nice contribution to the book itself. Jordan can correct me but here's the gist:

The "Warm Up" serves as a mini readiness assurance activity that's not necessary for the scaffolding of the section, but could still help reinforce prior knowledge going into a section. Each instructor can decide how to use it for their class.

The "Cool Down" provides students some next steps to help them prepare for the next section.

What are your thoughts @siwelwerd?

siwelwerd commented 2 months ago

I think this would make a great little project for our Edit-A-Thon. However, rather than merging this in now, I think I'd prefer to wait until we have them for every section. How about @jkostiuk just keeps committing them to this branch as he writes them, and then mark it as ready for review when they are all there? As long as it's done by the end of the Edit-A-Thon it will make it into the next edition of the book.

Making a note also to at some point verify that these are handled in the slides appropriately.

StevenClontz commented 2 months ago

Since we're on the same page that these should go into the next edition, I think I'd prefer more frequent PRs and a review process similar to what we're doing in Precalculus. If for some reason this ends up not happening before we launch 2024 edition, it's easy enough to stub them out.

StevenClontz commented 2 months ago

If we keep them all in a branch, we'll have one huge review at some point, as well as needing to possibly handle merge conflicts.

siwelwerd commented 2 months ago

Hmm, yeah. Your merge conflict point is a good one, I just don't like having the book in a state where there are features that only apply to parts of it.

I don't think what we are doing with Precalculus is relevant though, that book is in active development rather than a mature product.

StevenClontz commented 2 months ago

The rationale in my head for "2024 Edition PREVIEW" is that we're allowed to have in-progress content; we just have to make sure it's all cleaned up before we release it officially.

StevenClontz commented 2 months ago

@jkostiuk - heads up that this is now merged, so when you want to work on this feature more, you should get an updated copy of the main branch, then create a new warmupEV2 (or whatever) branch to continue working. Creating PRs that have only a few (no more than a chapter for sure) warmups/cooldowns is best so we can more easily review the content of the warmup/cooldown.

Actually, I want to think more carefully about this EV1 content, and if I have any suggested changes, I'll make a PR to that effect.