Week 1: Project Management


1. Introduction

During the first week of Fab Academy, I learned about project management and how to properly organize and document my work.

The main goal of this week was to: - Set up all necessary tools
- Learn how to use Git and GitLab
- Create and manage a personal website

This week is very important because it builds the foundation for all future assignments.


2. Installing Git

The first step was installing Git, which is a version control system used to track changes in files.

I installed Git using the terminal:

sudo apt update
sudo apt install git

Then I checked if Git was installed correctly:

git --version

This confirmed that Git is ready to use.


3. Setting Up GitLab

Next, I created an account on GitLab and prepared my repository.

GitLab allows me to: - Store my files online
- Track changes
- Collaborate and manage projects

I created a new repository where I will upload all my weekly assignments and documentation.


4. Cloning the Repository

After creating the repository, I cloned it to my computer:

git clone https://gitlab.com/your-username/your-repository.git

Then I opened the project folder:

cd your-repository

Now I can work on my files locally and edit them using VS Code.


5. Installing MkDocs

To create my website, I installed MkDocs:

pip install mkdocs

Then I created a new MkDocs project:

mkdocs new my-site
cd my-site

This created the basic structure of the website.


6. Running the Website Locally

To preview the website, I ran:

mkdocs serve

Then I opened this link in my browser:

http://127.0.0.1:8000

This allowed me to see my website live and make changes in real time.


7. Editing the Website

I edited the website using Visual Studio Code.

Main files: - mkdocs.yml – controls site navigation and settings
- docs/index.md – homepage
- Additional .md files for each assignment

I added my own content, structured the pages, and organized everything clearly.


\ 8. Pushing Changes to GitLab

After making changes, I uploaded them using Git:

git add .
git commit -m "week 1 project management"
git push

This saves my work and updates the repository.


9. Publishing the Website

Finally, I published my website online:

mkdocs gh-deploy

This automatically builds and deploys the website.


10. What I Learned

This week I learned: - How to install and use Git
- How to work with GitLab
- How to use terminal commands
- How to build a website using MkDocs
- How to manage and document my work


11. Conclusion

This week was essential for setting up the foundation of Fab Academy.

Now I have a working website where I can document all my assignments. I also understand how to use Git for version control and how to manage my projects efficiently.