search

carpentries-incubator / jekyll-pages-novice

Building Websites with Jekyll & GitHub Pages.
https://carpentries-incubator.github.io/jekyll-pages-novice/
Other
16 stars 21 forks source link

Running a pilot workshop #271

Closed apandas closed 1 year ago

apandas commented 2 years ago

Running two workshops at University of California, Santa Barbara:

tobyhodges commented 2 years ago

Great to hear that, @apandas. We'll be delighted to receive any feedback you have on the lesson. If you have any questions for us before the workshops take place, feel free to ask here or on our Slack channel.

jonjab commented 2 years ago

We had a great time doing this lesson in 3 hours.

We needed more time. We think 4 hours would be adequate. Most of what we cut out involved the roster of lab mates and the named-entity links ( links.md )

Suggestions:

After includes, it seems the blog example that showcases the collections function is the highlight of the lesson. Is a blog the best example? Should the metaphor of a 'group website' be extended, and you can call the collection the group's newsletter. Or lab diary?

I am thinking about doubling down on the surgeon's diary

Layout inheritance is another aspect that could be more emphasized in the script. default, homepage, blogpost are the three you wind up with in the lesson. We propose moving the blog / newsletter / whatever to its own page, to emphasize that there are 3 layouts that all descend from default.

We will try to circle back and submit individual issues.

tobyhodges commented 2 years ago

Thank you very much for the feedback so far @jonjab! We are very glad to hear that you enjoyed teaching the lesson 😄 Your suggestions so far have been noted, and we would love it if you would open individual issues for the points you have mentioned already, and anything else that you noted down and/or would like to report.

We are interested in any and all feedback you have, but particularly in anything about the final wrap-up exercises, customising a theme - that section was added since the last time we taught the lesson and we are keen to hear how well it fits.