syclacademy icon indicating copy to clipboard operation
syclacademy copied to clipboard

Questions regarding the structure of this repo and its materials

Open nmnobre opened this issue 1 year ago • 1 comments

Hi,

I'm a bit confused regarding the general structure of the repo and its materials, so I thought I'd ask:

  1. It is my understanding that index.html holds the most up-to-date lecture material and that the pdf is provided just for convenience. How can we make sure that they don't get out of sync? In particular, how do you guys normally generate the pdf? Addressed in #241. (I'll do my bit and regenerate all pdf files once my PRs are merged 🙂)

  2. I think the trend has been to move all the image assets under Lesson_Materials/common-revealjs? If that's the case, we could probably move all remaining images there and remove duplicates? Addressed in #240.

  3. Does it make sense for the exercises to pass the Catch2 tests even if the user/learner doesn't touch them, or should we rewrite them so the exercises fail unless the task is completed? As is, maybe I'd vote for the removal of Catch2 as suggested in #148.

Cheers, -Nuno

nmnobre avatar Apr 25 '23 11:04 nmnobre