👋 Welcome to project-tech!
This getting started guide will get you up and running with all the software and tools you need for this course. Throughout this guide there are additional video's that further explain important topics from lectures but also show you how to install certain technology. Look for a 🎦 emoji!
If you don’t have one yet, install a text editor. It doesn't really matter which one you pick, as long as you feel comfortable using it. However, we do recommend moving away from Brackets, other editors offer better customizability. VSCode is our recommended choice but there are other. Atom and Sublime are both also good choices.
Take some time to learn the interface and features of VSCode. If you know your way around the interface, coding will be easier. Feeling comfortable with your tools is very important when writing code.
🎦 Watch a video on how to install Text Editors.
If you haven’t already, sign up for GitHub. Take some time to set up your GitHub profile. Include your name, a profile picture, and a URL to your homepage. Teachers will appreciate it if you upload a representing profile and pick a username that closely resembles your real name. Silly pictures are allowed 🤪
You’re allowed to stay anonymous online for this course by omitting sensitive information, but a good looking GitHub profile can help you get an internship or job later.
🎦 Watch a video on how this GitHub organisation works.
Windows:
If you’re on Windows, you should upgrade to Windows 10 (1903) and install the Windows Subsystem for Linux using this guide (or video)
. Follow it until you see “Installation successful”. Additionally you can install the Windows Terminal and switch to using WSL.
💡 Be ware that lecturers may not be able to help you with very specific Windows problems. Additionally some resources used in this course show the MacOS interface. If you're on Windows many tools offer equivelant experiences and most steps and commands you enter will be the same. If something is different on Windows, please let your instructor and other students know in the
#windowschannel so we can troubleshoot and look at alternatives!
MacOS:
Apple already has a terminal emulator by default to provide a command line interface. Just search for terminal in spotlight or find it in your applications folder. There are other command-line interfaces out there you can download that add more feature. Hyper and iTerm are very popular choices.
💡 If you have a Mac running MacOS Catalina (or above) the current default shell is
zsh, previously this wasbash. Ifbashis still the default on your machine we highly suggest you switch your default shell tozshusing this Apple support article.
Windows:
If you installed the Windows Subsystem for Linux just now, install Git by running apt-get install git in Bash.
MacOS:
Install Git using Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"then install Git
brew install gitConnect Git and GitHub together inside of the terminal like so:
git config --global user.name "Mona Lisa"
git config --global user.email "mona@lisa.com"Use the same email for Git as you used to sign up for GitHub.
🎦 Watch a video on how to set-up gia via the terminal.
We use our DLO Brightspace for schedulers and rubric feedback. Make sure you enroll to the Project-tech course, you can do so by using the HvA courseselector. It's important to select the right class for teachers to give you feedback and grades. If you're not sure, ask your teacher to see if you are on the correct classlist.
Sign up for our Blok-Tech MS Team. You can find the sign-up code in the announcement on Brightspace. Join the #project-tech channel in our team. Get your account set up properly, add your real name, a profile picture, and you can even set your GitHub username as a status message. We’ll use this info to link your GitHub and MS Teams account to our administration files.
GitHub is a social platform so give this repository pt-course-20-21 a ⭐ star and start following your teachers and fellow students!
Wow, you did it! Virtual high five! 🖐 Now you can introduce yourself to your teacher and class. Open an issue on our GitHub issue tracker. You can pick what are called issue templates. Pick the Introduction template and fill in the details, then submit.
🚨 Make sure you never publicly share you name and student number in combination! If you fill in your class you can use your tech group
tech-xnot your 'regular'20xgroup.
Each assignment has a different template in which you can hand in your assignments for that week. This is also the place where teachers and student-assistants will give you feedback. You can use GitHub notifications (bell on the top right of the GitHub website) to keep track of changes.