Préparation

Comprendre son problème

Cela peut paraître évident, mais il est très important de bien comprendre le problème qu'on résoud. Surtout pour les projets autour de recherche et prototypage. Quand l'idée vient d'un·e prof·e ou d'une entreprise et pas de nous-même, on a parfois qu'une vague idée de pourquoi cette idée est née et pourquoi ça vaut la peine de creuser et faire des recherches.

Si on développe quelquechose de similaire à une solution existante, pourquoi cette solution n'est pas adapté au problème ? Quel valeur notre solution peut apporter ?

Ca permet de mieux comprendre où on va, quelles fonctionnalités prioriser, de justifier une décision technique,

Gestion des documents produits

Je conseille de créer deux repos Git, par exemple

  • tb-docs: en publique, pour versionner le contenu de son rapport. Evidemment, pour les TBs confidentiels, il sera en privé... mais pour le reste pourquoi en publique ?
    1. Parce que c'est super simple de donner accès à la dernière version du PDF du rapport durant des relectures. Pratique pour éviter le problème d'envoyer un PDF par Telegram, que la relecture démarre 2 jours plus tard, et que le PDF a bien été amélioré depuis...
    2. Parce que d'autres étudiant·es peuvent s'inspirer de votre texte, de la mise en page, de votre style d'écriture ou de la structure
    3. Parce que ça amène des curieux·ses à s'intéresser ou apprendre de votre travail
  • tb-notes: en privé, pour sauvegarder toutes vos notes, questions, brainstorming qui reste personnel et qui n'ont pas de raison d'être publié. Ce serait bête de perdre les questions et réponses que tu as posé à votre prof ou encore tous les TODOs à ne pas oublier pour le rapport.

Idées de structure du repos publique:

  1. Dans chaque dossier important, mettez un README pour expliquer ce qu'il contient et ce qu'on peut avoir.
  2. Metter un README principal avec des liens vers les documents importants (cahier des charges, rapport intermédiaire ou final)

Un dossier pour les POCs pocs, un dossier pour la préparation (cahier des charges et descriptif GAPS) dans le cas d'une idée apportée soi-même, et un dossier report pour le rapport.

.
├── pocs
│   ├── README.md
│   ├── lsp-server-demo
│   ├── tree-sitter-poc-dy
│   ├── websockets-json
│   ├...
├── preparation
│   ├── cdc.html
│   ├── cdc.md
│   └── descriptif-gaps.md
├── README.md
├── report
│   ├── bibliography.yml
│   ├── chapters
│   ├── imgs
│   ├── rapport-final-tb-plx.pdf
│   ├── rapport-intermediaire-tb-plx.pdf
│   ├...

Avec le README principal proposé suivant, à adapter en fonction des besoins et envies.

# Titre du TB

> Documentation de mon Travail de Bachelor (TB)

## Documents disponibles
1. [**Le rapport intermédiaire**](report/rapport-final-tb.pdf)
1. [**Le rapport final**](report/rapport-final-tb.pdf) TODO
1. [Descriptif de l'idée pour GAPS](./preparation/descriptif-gaps.md)
1. [Cahier des charges (cdc)](./preparation/cdc.md)
1. [Liste de POC des différentes technologies pour l'état de l'art](./pocs)

## Implémentation
L'implémentation se fait sur un repository séparé sur [?/?](???).

Directives de l'école

Il y a plusieurs documents qui sont inspensables d'avoir lu et qui sont nécessaires de revenir plusieurs fois dessus. Une partie est envoyée par le secrétariat, une autre est fournie par les enseignants.

Les exemples suivants concernent la situation de juillet 2025, les noms des documents seront pour une partie adaptée aux mises à jours annuelles ou au type de formation (PT ou EE).

  • Planning_TB2025_PT.pdf: le planning avec toutes les échéances et dates de rendus.
  • TB_Dispositions_applications_TIC_2025.pdf: Intitulé Travail de Bachelor, Dispositions d'application du Département TIC ce document contient notamment une section PRESENTATION DU RAPPORT qui comprend les éléments à ne pas oublier dans le rapport.
  • Directive de la HEIG-VD sur les travaux de bachelor.pdf: comme son nom l'indique, c'est d'autres directives plus larges pour toute la HEIG-VD.
  • Grille_evaluation_TB2022.xlsm: La grille d'évaluation utilisée ton prof, qui n'est pas forcément fournie...

TODO

Usage de l'IA

TODO

Le prof qui nous suit

Demander comment la communication doit se passer (email, teams, autre) et que faire quand on a pas de réponse à nos questions, est-ce qu'il faut relancer ou juste attendre ?

que faire quand en vacances ?

est-ce que ya le temps d'avoir un rdv chaque semaine ?