teach-rs icon indicating copy to clipboard operation
teach-rs copied to clipboard

Introduction tells you to clone the repository instead of using the generated exercises zip from the website

Open michielp1807 opened this issue 1 year ago • 4 comments

The introduction tells you to clone the repository to get access to the exercises. However, if you do this, the paths described in the exercises do not match the folder layout, as the exercises assume the folder layout of the generated exercises zip from the main page of the website.

For example, for Exercise 2.3.1, it says to follow the instructions of exercises/2-foundations-of-rust/3-advanced-syntax/1-error-propagation/src/main.rs. However, the exercise is actually located in content/mods/A-foundations/topics/optionals-errors/exercises/error-propagation/src/main.rs in the cloned repository. And similarly for the other exercises.

michielp1807 avatar Aug 27 '24 10:08 michielp1807

This might be more of a documentation issue, because this is intentional: the paths refer to the exercise structure in the generated exercise package. Modmod is used to take the content in the content folder and put it in the right place according to the given track specification. You can download the exercise package corresponding to your track here: https://teach-rs.trifectatech.org/

hdoordt avatar Aug 27 '24 10:08 hdoordt

Ah right, that makes sense. We might need to change the introduction, which currently tells you to clone the GitHub repo instead of downloading the generated exercise package.

michielp1807 avatar Aug 27 '24 14:08 michielp1807

Good call. Reopening this again

hdoordt avatar Aug 27 '24 18:08 hdoordt

@MichielP1807 can you update the title to match the actual issue of the introduction content not reflecting reality?

hdoordt avatar Sep 01 '24 19:09 hdoordt