dcs-notes.github.io
The live site is accessible here
Introduction
First of all, thank you for visiting this site! This website is a collection of notes for the modules in the first year computer science degree at the University of Warwick.
It is entirely student-run, and not affiliated with or endorsed by the University. We have communicated with members of the department who have said that this project is acceptable, but if at any point we are told this goes against DCS anti-plagiarism guidelines, or any other policy, we will immediately take it down. Additionally, we cannot provide guarantees that all the notes are correct as all content is written by students, however, we will try our hardest to maintain quality.
Note from the maintainers
If you've been linked to this site, you've probably also seen us asking for anyone who can to pull request. We know that many people are hesitant to put their notes up on this site, whether it be because they think other people seeing their revision material may indirectly disadvantage them, or that they don't think anything they make is good enough to be hosted on a public site - we were too! However, there are a couple of points we'd like to raise to encourage you to contribute and help this site to be the best it can be:
- Our course isn't marked on a curve, so others using your notes to get better doesn't detriment you
- Making notes is a great way to revise, as it makes sure you properly understand the content, and if you know you’re putting them somewhere it gives you accountability to actually get them done
- Any content that is contributed is great to have - it doesn't have to be perfect! The beauty of these types of projects is that they inherently allow collaboration, so we can work together to improve any problems you think might be present
- Having experience collaborating on an open source project through tools like Git is a really useful skill and is a lot more exciting than what we did with it in CS133, and being able give this as an example of where you've done it in practice could be a cool thing to put on your CV
- You'll get a neat icon of you in the contributors section of the README and index pages!
Licensing and downloading
This work is licensed under Creative Commons "Attribution-NonCommercial-ShareAlike 4.0 International", and the full license document can be found here. Essentially, attribute any content to the people who made it, don't use it to make money, and, even if you change the content, share it under the same license.
If you want to take a local download of the repository, please consider taking a fork as opposed to a clone, as that means it is easier for you to both stay up to date, and to contribute later if you want to. Furthermore, it helps us to some extent see how many people are interested in what we are doing.
Contributing
We welcome pull requests from anyone who is happy to share their notes, and would be incredibly grateful for any input of content for the individual pages! We will try to provide any reasonable attribution you would like for content you contribute, and any contributions mean we get a more full coverage of the content finished faster, so everyone on the course can benefit from high quality shared notes.
Guidelines for contributions
A full tutorial for contributors can be found here
To ensure the smooth running of the this project, and avoid any contributions having to be removed, please follow the below guidelines:
-
Please thoroughly research a topic/correction before making a pull request on the matter, to ensure accuracy
-
If you are directly sourcing content that is not your own, please add the correct citations. For images or text taken verbatim from a source, please include a link to the site it is taken from, and exercise common sense for other cases
-
Please do not re-host any university owned content, including but not limited to past papers and lecture notes
Style guide
The style guide can be found here
We will appreciate if contributors abide by these formatting guidelines, as it ensures that the layout of the website is perfect. That said, nothing will break if you don't do so, just certain things (table of contents) won't be as user friendly as it should be.
Contributors
This table is generated by the all-contributors bot. The emojis mean the following in this project:
- "
🐛 " means making a pull request to fix mistakes in someone else's notes - "
🖋 " means contributing notes to the project (this supersedes🐛 ) - "
👀 " means reviewing notes contributed by someone else to the project - "
🎨 " means doing design work for the website - "
🔥 " means being responsible for internal administrative tasks (note:🔥 is a custom key named "admin")
Contact us
Currently, the maintainers/admins for this project are: Akram Ahmad, Edmund Goodman, Justin Tan, Yijun Hu (founding members), and Josh Fitzmaurice, Joseph Evans, Leon Chipchase, and Leo Riviera.
If you have any additional questions, or want to become more involved in contributing to this project, please feel free to DM us on WhatsApp or Discord (search for our names within the main first year CS group chat, or the grey or cult servers).
Many thanks once again for visiting.
Dank Memes
