Skip to content
This repository has been archived by the owner on Jan 9, 2023. It is now read-only.

Latest commit

 

History

History
120 lines (75 loc) · 6.98 KB

getting-started.md

File metadata and controls

120 lines (75 loc) · 6.98 KB
Raw

Project-tech - Getting Started

Table of Contents

Description

👋 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!

Prerequisite

Text Editor

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 others. 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.

GitHub

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.

Installation

CLI

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 #windows channel 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 features. Hyper and iTerm are very popular choices. Many people also like to use the Intergrated Terminal directly in your code editor like in VSCode.

💡 If you have a Mac running MacOS Catalina (or above) the current default shell is zsh, previously this was bash. If bash is still the default on your machine we highly suggest you switch your default shell to zsh using this Apple support article.

Git

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 git

Connect Git and GitHub together inside of the terminal like so:

git config --global user.name "Mona Lisa"
git config --global user.email "[email protected]"

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.

Communication

Brightspace

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. Go to Administration > Groups and pick the right class. If you're not sure, ask your teacher to see if you are on the correct classlist.

Microsoft Teams

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

GitHub is a social platform so give this repository pt-course-21-22 a ⭐ star and start following your teachers and fellow students!

Introduction

Wow, you did it! Virtual high five! 🖐 During this course we'll use GitHub issues and templates. 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 those changes.

🚨 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-x not your 'regular' 20x group.

/Happy Coding!