carpentries / lesson-infrastructure

4 stars 3 forks source link

Revamp navigation bar for lessons #18

Open rgaiacs opened 6 years ago

rgaiacs commented 6 years ago

Suggestion

screenshot from 2018-06-22 22-23-37

screenshot from 2018-06-22 22-23-46

screenshot from 2018-06-22 22-24-02

ChristinaLK commented 6 years ago

At some point it would be nice to have the instructor notes as a top level menu item, if that's where the community wants to put all of its wisdom about teaching a particular lesson.

Not needed for this change, but food for thought.

rgaiacs commented 6 years ago

At some point it would be nice to have the instructor notes as a top level menu item, if that's where the community wants to put all of its wisdom about teaching a particular lesson.

I have mixed feelings about this. At the moment, the "Extras" item capture everything that isn't a episode neither things that all readers should know about (Licence and Code of Conduct). Instructor Notes is something that is more useful to instructors than learners so I have the feeling that we should have one item "Extras for Learners" and another "Extras for Instructors" but I want use _learners and _instructors directories.

ChristinaLK commented 6 years ago

Organizationally, I can see why the notes are in extras -- compared to the lesson materials, they are. But I think the notes are (or could be more) important, and it's easy for instructors to not realize that they're there because they're tucked away in the extras tab.

So another way to think about the organization of content is that "episodes" is the info for learners + "notes" is info for the instructor + "extras" is everything else. And of course the License + CoC as their own items.

rgaiacs commented 6 years ago

What about

screenshot from 2018-06-27 15-53-30

screenshot from 2018-06-27 15-53-48

screenshot from 2018-06-27 15-54-10

It should indicate to learners that we have one page with references and some extra discussions as well as indicate to instructors that we have some supporting material (instructor notes and page only with figures) that we can expand later to have slides with the figures or slides with the exercises.

ChristinaLK commented 6 years ago

I think this looks great!

brownsarahm commented 6 years ago

I like this a lot too!

This makes the "extra" content more accessible to both instructors and learners