Resource Collections

For each course, we collect notes, texts, exercise solutions, exam papers, books, handouts, slides, and much more in an organized manner. Once uploaded, they become accessible on our public instance: dynamik.vercel.app.

Quality Control

When contributing your resources or about to accept someone else’s work, make sure:

not to upload/accept duplicate, incomprehensible, useless, offensive, or illegal content;
that all automatic checks pass;
to use, where possible, “source” .tex/.md/.typ/.doc(x)/.odt(x) and similar files instead of their compiled PDF/HTML counterparts (and never unembedded images in other documents);
to upload, if possible, the resource itself rather than a link to an external version: this way, you enable other people to expand and correct it in the future.

Updating Collections in Bulk

Introduction The repository cartabinaria/update contains a simple Bash script to apply the same patch (in .diff format) to all course repositories at once. Before You Begin For each repository, passwords for any ssh and gpg keys are prompted by git about 4 times.

Oct 6, 2023

Contributing to a Course

If you’re new to this, using GitHub’s web interface is an easy way to contribute to a course’s resources: When you view the resources you want to modify, to the right of the path at the top of the page, click on the GitHub icon ; In the top right, click on “Fork” and, on the resulting page, “Create fork”; You will see github.

Jul 29, 2023

Adding a New Course

Adding a new course is easy if you are already within the CartaBinaria organization on GitHub: On template-it/template-en, use “Use this template”/“Create a new repository”; As the new name, use the-kebab-case-convention, ing- as a possible prefix for Computer Engineering, isi- as a possible prefix for Computer Science and Engineering, or ipim- as a possible prefix for Information Science for Management (no prefixes are needed to distinguish between bachelor’s and master’s courses); As the description, use a phrase similar to “A collection of resources for the Programming Languages course (04138) of the Bachelor’s Degree in Computer Science”; Choose “Public” and proceed to “Create repository from template”; Enable GitHub Pages from “Settings” / “Pages” setting “Source” to “GitHub Actions”; Grant “Maintain” rights to the relevant groups.

Jun 6, 2023

Automated Checks

When there are new changes on a PR or on the main branch, some automated checks are performed. It’s important that all checks pass before the PR is accepted. Moderators will help you along the way.

Apr 5, 2023