Week 01

Principles and Practices Project Management

During Week 01 of Fab Academy, the main goal was to establish the technical foundations required for documentation and version control. This week focused on understanding the course structure, learning how Git works, and setting up the tools needed to manage and publish all future work.

Week 3 cover

Assignment Requirements

Individual assignment

  • download, read, and sign the student agreement, and commit the file to your repo
  • work through a git tutorial
  • build a personal site in the class archive describing you and your final project

Git Installation

The first step was to install Git, which is the version control system used throughout Fab Academy to manage files and documentation. Git was downloaded from the official website: git-scm.com. After downloading the installer for my operating system, I followed the default installation steps until completion.

Git installation process

Installing Visual Studio Code

Visual Studio Code was installed as the main code editor to manage files, write documentation, and interact directly with Git repositories. VS Code was downloaded from the official website: code.visualstudio.com. Its built-in Git integration simplifies committing and pushing changes.

Visual Studio Code installation

GitLab and Fab Academy Repository

Fab Academy uses GitLab as the main platform to host student repositories and publish documentation. Each student is provided with a personal GitLab repository connected to the Fab Academy class archive.

GitLab works together with Git: Git manages changes locally, while GitLab stores the remote version of the repository online.

Fab Academy GitLab repository

Cloning the Repository

Once Git and VS Code were installed, the next step was to clone my Fab Academy repository to my local machine. This allows working locally and synchronizing changes with the remote repository.

The repository was cloned using the terminal with the following command:

git clone <repository_url>
  
Cloning Fab Academy repository

Git Authentication and Token Setup

To allow Git and Visual Studio Code to push changes to GitHub, authentication was configured using a personal access token. This token grants permission to update the remote repository securely.

Once generated on GitHub, the token was used when prompted by Git and stored securely by Visual Studio Code for future commits.

GitHub token configuration

Local Workflow

All files are edited locally using Visual Studio Code. The workflow followed during Fab Academy ensures that every change is tracked and properly documented.

The basic workflow consists of editing files locally, committing changes, and pushing updates to the remote repository.

Local workflow in VS Code

Pushing Changes to the Repository

To publish updates and reflect changes on the Fab Academy website, the following Git commands were used:

git add .
git commit -m "Update Week 01 documentation"
git push
  
Git push confirmation

9) Reflection

What did you learn? What would you improve next time?

10) Errors & Fixes

11) Downloads

Sections