Week 1 - Project management

Assignment

Plan and sketch a potential final project
Read, sign (add your name to) the student agreement and commit it to your repo
Work through a git tutorial.
Build a personal website in the class archive describing yourself and your final project. Refer to the lecture material for examples.
Upload parts 1 and 2, to the class archive.

Summary

This week, I focused on defining my final project idea and familiarizing myself with the documentation process. Additionally, I dedicated time to learning about GitLab and version control, setting up my own GitLab environment, and customizing my default GitLab webpage with my personal content.

1. Principles and Practices

   Planned and sketched my fianl project

2. Learning About GitLab

   I started by diving into some helpful resources from the GitLab YouTube channel. The playlist covered the basics of GitLab, how it works, and its various features. I followed the tutorials in the playlist to build a foundational understanding of version control and GitLab's role in collaborative projects.

   Git is a version control system that helps track changes in code or files. It also enables multiple people to collaborate on a single project.

   Gitlab is a platform that helps store and manage documentation, ensuring all changes are saved and organized.

   In short, Gitlab helps developers to develop, deploy and secure software and easy collaboration.

   Gitlab Youtube Link

3. Signing In & Setting Up GitLab

   I signed into Gitlab using with Fablabs account then started editing my profile (location,organization,timezones,..)
   Created SSH key
   SSH Key (SSH - Secure Shell) is a cryptographic key that helps to securely connect my local computer to the Gitlab without using password every time.
   To create ssh key I used Git bash terminal(You can also use other terminals such as: command prompt)
   

   • Opened terminal - Gitbash
   • Run

                       
                         ssh-keygen -t ed25519 -C
                       
                     

   In my case I choosed ED25519 key type (It is faster and require fewer resources in terms of time and space)

   • Accepted directory and left blank passphrase (you can set one for extra security)
   
   • Navigated to the location where I stored SSH key and copied the text from there
   • Pasted it into my Gitlab
   
   • Set Title, Usage type, Expiration date

   I choose Authentication & Signing, No expiration date(to set this, leave the box empty)

   • Clicked Add key
   
   Addition, I had Gitbash and Visual Studio Code(vscode) already installed on my pc
   
   • Gitbash is command-line interface which helps to run Git commands.

   Download

   • Visual Studio Code is a code editor that provides developers with the tools they need to write, debug, and manage code effectively.

   Vscode download

   VSCODE alternatives: Sublime Text, Atom

4. Cloning Repository

   Cloning refers to creating a local copy on a pc of the remote repository(Gitlab repository).
   

   Key terms

   1. Repository - is a collection of files and their history. (It stores files and also tracks changes to those files over time, enabling collaboration, versioning, and tracking history)
   2. Directory - (folder) is a container used to organize files and other directories.
   Steps to clone
   1. Opened my gitlab repository
   2. Under code tab
   
   3. Copied link under Clone with SSH (You can also use link under clone with HTTPS)
   4. Opened Gitbash terminal in vscode
   5. Navigated to the location to store my project
   6. Pasted the link after git clone command

                   
                     git clone git@github.com:username/repository-name.git
                   
                 

   

5. Modifying my webpage

   After cloning, I started customizing the default webpage on my GitLab by replacing the placeholder content with my own stories.
   Using my web development skills in HTML and CSS, I modified the page, adding personal details and applying stylish elements to improve its overall look.

   

6. Adding Student Agreement

   I created a file for Fab Academy Student Agreement and signed it by adding my names

   FabAcademy Student Agreement File

7. Adding changes to Gitlab

   1. Pulling is downloading changes from the remote repository(Gitlabs) to local repository(PC)
      Steps to pull
      • Open terminal
      • Navigate to the local project
      • Use command

                          
                            git pull
                            For the latest changes
                          
                        

   2. Pushing is uploading local changes to the remote repository.

   Steps for adding changes to Gitlab

               
                 git status 
                 To check modified files
               
               
                 git add .
                 To add all modified files
               
               
                 git add <filename>
                 To add a specific file
               
               
                 git commit -m "Your commit message here"
                 
                   Commit message should be clear and describing the changes you made 
   
                   For instance: Fix broken image links on the homepage
                 
               
               
                 git push
                 To Upload changes