How to do an exam for the Internet Programming course

0. Prerequisites

1. In order to do the exam for the Internet Programming course, you need to have a GitHub account. If you don't have one, go to GitHub and create one. You can use your university email address, or any other email address you have access to.
2. You need to have Git installed on your computer. If you don't have it, go to Git and install it. You can use the default settings for the installation.
3. You need to have a code editor installed on your computer. You can use any code editor you like, but I recommend Visual Studio Code. You can use the default settings for the installation.
4. You need to have Node.js installed on your computer. If you don't have it, go to Node.js and install it. You can use the default settings for the installation.
5. You need to have a browser installed on your computer. You can use any browser you like, but I recommend Google Chrome. You can use the default settings for the installation.
6. You need to be familiar with the basics of Git and GitHub. If you are not, go to Git Handbook and read the first two chapters: "Getting Started" and "Git Basics". You can skip the "Git Branching" chapter for now.
7. You need to have TypeScript installed globally on your computer. If you don't have it, open a terminal and run the following command: npm install -g typescript. You can verify that it is installed by running the following command: tsc --version. It should print the version of TypeScript installed on your computer. If you get an error mentioning an execution policy, run the following command: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser and try again.

1. Fork the repository

1. Go to the exam repository page: https://github.com/sweko/uacs-internet-programming-exams
2. Click on the "Fork" button in the top right corner of the page. This will create a copy of the repository in your GitHub account.
3. Go to your GitHub account and open the forked repository. The URL should be something like https://github.com/<your-user-name-here>/uacs-internet-programming-exams

1.1 Sync your fork with the original repository

If you already forked the repository

1. Go to your forked repository page
2. Click on the "Sync fork" button in the top right corner of the page. This will sync your fork with the original repository. More details are available here

2. Clone the repository

1. Go to your forked repository page
2. Click on the "Code" button in the top right corner of the page
3. Copy the URL of the repository
4. Open a terminal and run the following command: git clone <url-of-the-repository>. This will create a local copy of the repository on your computer. The URL should be something like https://github.com/<your-user-name-here>/uacs-internet-programming-exams.git

3. Make sure that you have the correct folder structure

1. Locate the folder for the correct exam. The folder name should be something like finals-<current-date>.

2. Inside that folder will be a folder called docs and a folder called code. The docs folder contains the instructions for the exam, and the date folder contains the code for the exam.

3. The code folder should contain folders with student ids. Locate the folder with your student id and open it. It should contain an angular application. This is where you will write your code for the exam.

4. Install the needed scripts by running the following command: npm install. This will install the needed scripts for the angular application. Note: If you are using Visual Studio Code, you can use the built-in terminal to run the command. The terminal can be opened using the Ctrl + ~ keyboard shortcut.

5. Run the following command: npm start. This will start the angular application. You can access it by opening a browser and navigating to http://localhost:4200/. You should see a page with the text "Hello World!".

4. Do the exam

1. Open the markdown file in the docs folder in your browser. It should be something like finals-<current-date>/docs/readme.md. This is the file with the instructions for the exam.

2. Carefully read the instructions for the exam. If you have any questions, ask the instructor.

3. Execute the instructions for the exam. Note that the instructions may require you to do some research on your own, and that you may need to use the internet to find the information you need. However, you are not allowed to ask for help from anyone else, and you are not allowed to use generative AI's like GPT-3 to generate the code for you. Additionally, usage of personal electronic devices (phone, laptop, ....) is disallowed as well.

5. Commit and push your changes

1. Open a terminal and navigate to the folder for the exam. The folder should be something like finals-<current-date>/code/<your-student-id>

2. Run the following command: git add .. This will add all the files in the folder to the staging area.

3. Run the following command: git commit -m "<your-commit-message-here>". This will commit your changes to the local repository. Make sure that your commit message is descriptive enough to understand what you did.

4. Run the following command: git push. This will push your changes to your remote repository. Note, if the push fails, refer to the FAQ.

5a. Commit and push your changes (alternative)

1. Use the Visual Studio Code interface to commit and push your changes. More details are available here

6. Create a pull request

1. Go to your forked repository page

2. Click on the "Pull requests" tab

3. Click on the "New pull request" button

4. Click on the "Compare across forks" link

5. In the "base repository" dropdown, select the original repository, i.e. sweko/uacs-internet-programming-exams

6. In the "head repository" dropdown, select your forked repository, i.e. <your-user-name-here>/uacs-internet-programming-exams

7. Click on the "Create pull request" button

8. Add a descriptive title for your pull request

9. Add a descriptive description for your pull request (including your name and student id)

Note that you can continue to push changes to your forked repository, and the pull request will automatically update with the new changes. However, you should not push any changes after the deadline for the exam has passed.

7. Wait for the results

The instructor will review your pull request and provide feedback on your work.