# Documenting Design

In our first web development class, we were introduced to the terminal and Git. At first, I have to admit, the terminal felt a bit intimidating, navigating a computer with text commands instead of clicking around? It seemed daunting! But as I practiced, I realized that it's not as scary as it looks. 

{% hint style="info" %}
The [website](https://fablabbcn-projects.gitlab.io/learning/educational-docs/mdef/classes/git-setup/) with all the course useful information
{% endhint %}

***

**Terminal Basics**

We learned the basic commands for navigating around the computer using the terminal, which is an essential skill when managing our website files. Simple things like listing files in a directory (`ls`), moving between folders (`cd`), and creating new files or directories will soon feel natural.

***

**Introduction to Git**

Git, as we learned, is more than just a tool for building websites, it's a version control system. This means you can keep track of every change you make to your files, which is super useful not only for code but for any project. We practiced using the diagram you can see here:

<figure><img src="https://1501267263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIlkwX5sCFwXQQal0c7Nk%2Fuploads%2F1obMjt8faR8DjAhx6R2N%2FCaptura%20de%20pantalla%202024-10-14%20101911.png?alt=media&#x26;token=e06ec514-7115-48fa-abbc-6968235323d8" alt=""><figcaption><p>Git structure diagram</p></figcaption></figure>

In this diagram, we practiced how files move through different stages: the *working directory* and then the *local repository* before finally pushing them to the *remote repository* (like GitHub).

***

**Gitbook vs. Mobirise: My Preference**

After mastering the basics, we were introduced to two tools to help build our websites: **Gitbook** and **Mobirise**. Personally, I went with Gitbook because it seemed easier and had a lot of hidden potential I was curious to explore. With a bit of searching, I even managed to set up my navigation bar with headings for "Home," "About," and "Terms." Small wins! But hey, you can now check out how my website is coming along!

{% hint style="info" %}
Useful information on the functionalities of [Gitbook](https://docs.gitbook.com/)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://javierserraa.gitbook.io/term-1/courses/documenting-design.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.