Adding a New Course

Adding a new course is easy if you are already within the CSUnibo organization on GitHub:

1. On template-it/template-en, use “Use this template”/“Create a new repository”;
2. As the new name, use the-kebab-case-convention, eng- as a possible prefix for Computer Engineering, cse- as a possible prefix for Computer Science and Engineering (no prefixes are needed to distinguish between bachelor’s and master’s courses);
3. As the description, use a phrase similar to “A collection of resources for the teaching of Programming Languages (04138) of the Bachelor’s Degree Course in Computer Science”;
4. Choose “Public” and proceed to “Create repository from template”;
5. Enable GitHub Pages from “Settings” / “Pages” setting “Source” as “GitHub Actions”;
6. Grant “Maintain” rights to the relevant groups. For example, for a second-year Computer Engineering course, the Computer Engineering second and third-year groups should be added. It is not necessary to remove oneself from the Admin role;
7. On the main page of the new course on GitHub, click on the gear next to “About”;
8. As “Website”, use https://resources.students.cs.unibo.it/repository-name, and uncheck “Releases” and “Packages”, then add “Topics” as desired and click “Save changes”;
9. Update the README filling in every placeholder;
10. Add any extensions you want to appear on the resulting website by modifying .github/workflows/build-and-deploy.yml;
11. Add the new course to degrees.json and teachings.json in the csunibo/config repository.

That’s it! If you want the course to also appear in the lists of Dynamik, Informabot, or other services, simply update the git submodule of csunibo/config in the respective repositories.