-
Notifications
You must be signed in to change notification settings - Fork 516
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
SWC syllabus episodes out of sync with material and not using site.curriculum variable #684
Comments
As an aside, in 2 recent workshop websites I have set up - I have simply baked the links to lessons into the schedule and have completely scrapped the syllabus section to reduce the page size:
But I understand that having a separate syllabus section is beneficial as long as lesson titles in schedule match those in syllabus (which is not the case at the moment) and the links are all correct and match the selected site.curriculum. |
Thanks for bringing this up @anenadic. We'll be discussing this with the Curriculum Team next week and we'll get back to you. |
For more context, this is due to the fact that these are baked into workshop-template/_includes/swc/syllabus.html Lines 15 to 24 in 87da500
@anenadic, when you say 'reduce the size of the workshop page' are you referring to the physical length of the page on a computer screen or the size in bytes (that may affect how long it takes the page to load)? |
I mean the size on the computer screen - the page is already very verbose with loads of content on it and my fear is that loads of info does not get read or noticed by the workshop participants because of it. From my experience, installation instructions regularly get overlooked :-(. |
A couple of issues with the SWC syllabus:
I have seen a similar issue #648 and the RFC#4 discussion at carpentries/maintainer-RFCs#4.
I propose that we simplify the syllabus pages to simply contain the name of the lessons with links to lesson pages and to scrap the individual lesson episode lists/links (but utilise the site.curriculum and site.flavour (for DC) variables as planned). This will reduce the size of the workshop page as well as simplify maintenance and reduce potential errors that are introduced when lessons change and syllabus gets out of sync. While it is nice to have individual lesson episodes listed - I am not sure they bring much benefit to participants especially if they are wrong. In my opinion, linking to the 'home' of the lesson website where all episodes are clearly listed is a much better way.
I understand that this will require a discussion by the maintainers team. I am happy to do a PR with the proposed changes.
The text was updated successfully, but these errors were encountered: