Gestion de projet et documentation#

Voici ma toute première documentation, marquant mes premières étapes d’apprentissage. Elle englobe des sujets tels que l’introduction à GitLab, HomeBrew, et la clé SSH. En tant que débutante dans ce domaine, je m’efforce de définir et décrire mes actions même si je ne les comprend pas toutes très bien !

1. Introduction#

Pendant cette première séance Denis nous a exposé les outils de base indispensables pour la documentation. En parallèle, il nous a plongés dans les principes et à la philosophie du FabLab, tout en éclairant l’objectif de la formation : cultiver des compétences essentielles dans la maîtrise des outils numériques et, bien entendu, se lancer dans un projet captivant !

2. Mise en place#

Etape 1 : Installer Brew et Git#

Étant sur un Mac OS, la première étape était d’installer Homebrew, une plateforme simplifiant l’installation de programmes. J’ai récupéré le code d’installation de Brew sur leur site et l’ai exécuté dans le terminal : 

% /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Ensuite, j’ai tenté d’achever l’installation en copiant et collant les commandes suivantes :

(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/galatoscano/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"

Cependant, cela a échoué pour une raison inconnue.

J’ai sollicité l’aide de Denis car le codage n’est pas mon point fort.

Nous avons trouvé un lien vers la documentation de Brew, où un autre code pour « mirroring » ma localisation a été trouvé, permettant une installation réussie et rapide.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Une fois l’installation réussie, j’ai simplement tapé :

brew install git

Etape 2 : Installer la clé SSH#

Mais d’abord : qu’est-ce qu’une clé SSH ? Une clé SSH c’est un peu comme une sorte de passeport numérique qui sécurise et facilité l’accès à des services en ligne comme Git sans avoir besoin de mots de passe à chaque connexion.

J’ai eu du mal à installer cette clé SSH, mais Charles m’a donné quelques instructions avant la fin du cours pour m’en sortir, un grand merci à lui !

Générer la clé SSH avec une commande spécifique#

ssh-keygen -t ecdsa -C "gala.toscano-aguilar@ulb.be" -P ""

Copier ma clé SSH a été un problème : le fichier est introuvable ??

J’ai découvert que le fichier était en réalité “caché”. Suivant les conseils de ChatGPT, j’ai effectué les étapes suivantes :

  • J’ai exécuté la commande killall finder pour redémarrer le processus de Finder sur mon ordinateur.

  • J’ai fait apparaitre tous mes fichiers en changeant les préférences de Finder mais cela n’a rien donné.

  • J’ai exécuté la commande defaults write com.apple.finder AppleShowAllFiles true pour faire apparaître mes fichiers cachés, mais sans succès.

  • Chatgpt a suggéré d’exécuter les commandes suivantes :

cd ⁓/.ssh : Pour me rendre dans le répertoire .ssh

ls : Pour afficher la liste des dossiers .ssh

Ce qui m’a permis de enfin voir les fichiers id_ecdsa et id_ecdsa.pub

cat id_ecdsa.pub : Pour copier le contenu de id_ecdsa.pub

Youpie j’arrive enfin à voir le contenu de ce fichier !

Prochaine étape : copier et ajouter ma clé sur mon compte git. J’ai copié cette fameuse clé et l’ai collée dans la partie « clé SSH » de mon espace Git.

Dernière étape : cloner ma clé. J’ai encore rencontré quelques soucis, mais rien de grave. Mon terminal ne reconnaissait pas le code SSH, donc j’ai essayé avec le code URL HTTPS, ce qui a finalement abouti avec succès ! Ma clé est correctement clonée :)

3. VSCode ou pas…#

Au lieu d’utiliser VSCode dès le début, j’ai plutôt pris des notes pour ma documentation sur Word. J’ai pourtant suivi toutes les étapes nécessaires pour pouvoir me servir de cet éditeur de code (clé SSH, clonage,…) mais j’avoue que j’étais plus à l’aise sur Word. Ce n’est peut-être pas l’idéal, mais cela m’a très bien convenu. Une fois mes textes rédigés, je vais simplement sur GitLab, dans mon espace, où je fais un « commit » de mon contenu.

4. Comment faire pour compresser mes images sur Mac ?#

Pour effectuer cette opération sur Mac OS, je me suis rendue dans la barre d’outils et j’ai choisi l’option « Ajuster la taille ». Dans ce menu, il est possible de moduler la résolution à souhait, offrant un contrôle sur la compression.

5. Gestion de projet#

Les techniques proposées par Denis (notre professeur) dans cet article sont très intéressantes.

Les techniques clés à retenir :

  • Décomposition des tâches : Un projet complexe peut toujours être décomposé en tâches plus petites qui semblent abordables. Hiérarchisation des tâches : Classer les tâches par ordre d’importance, en commençant par les plus critiques pour le succès du projet.

  • Gestion en spirales : Réaliser rapidement une première version minimale fonctionnelle du projet, puis évoluer en ajoutant des fonctionnalités ou des améliorations en spirales successives.

  • Gestion du temps plutôt que des tâches : Il faut se concentrer sur la gestion du temps. Fixer des délais pour les tâches et allouer des créneaux horaires en fonction du temps disponible.

  • Triage en cas de dépassement du délai : Si le temps imparti est écoulé et des tâches restent, il faut effectuer un triage. On peut reporter ou annuler les tâches en fonction de la nouvelle réalité et des ressources restantes

Je vais m’efforcer de bien me rappeler et d’utiliser ces différentes techniques pour réussir à surmonter les défis liés à la gestion de projets !