From 814c27be4affbc0377c8672a5caf24f7088ec79e Mon Sep 17 00:00:00 2001
From: Maxime Dupont <m.dupont103@gmail.com>
Date: Sat, 29 Jul 2023 14:01:35 +0200
Subject: [PATCH] Add more glossary entries (#42)

* Add more glossary entries

* Apply suggestions from code review

---------

Co-authored-by: Romain l'Ourson <rcrestey@gmail.com>
---
 documentation/docs/05-misc/01-faq.md          |  2 +-
 documentation/docs/07-glossary/02-web.md      |  6 ++++
 .../docs/07-glossary/03-javascript.md         | 19 +++++++++--
 documentation/docs/07-glossary/04-sveltejs.md | 32 +++++++++++++------
 4 files changed, 46 insertions(+), 13 deletions(-)

diff --git a/documentation/docs/05-misc/01-faq.md b/documentation/docs/05-misc/01-faq.md
index 88fb63e266..85b552770c 100644
--- a/documentation/docs/05-misc/01-faq.md
+++ b/documentation/docs/05-misc/01-faq.md
@@ -30,7 +30,7 @@ Vous pouvez utiliser Prettier avec le <span class="vo">[plugin](/docs/developmen
 
 ## Comment documenter mes composants ?
 
-Dans les éditeurs qui utilisent le <span class="vo">[Svelte Language Server](/docs/sveltejs#svelte-language-server)</span> vous pouvez documenter les composants, fonctions et exports à l'aide de commentaires spécialement formatés.
+Dans les éditeurs qui utilisent le <span class="vo">[Language Server](/docs/web#language-server)</span> Svelte ([svelte-language-server](https://www.npmjs.com/package/svelte-language-server)), vous pouvez documenter les composants, fonctions et exports à l'aide de commentaires spécialement formatés.
 
 ```svelte
 <script>
diff --git a/documentation/docs/07-glossary/02-web.md b/documentation/docs/07-glossary/02-web.md
index 09f53b7758..485d19d0a9 100644
--- a/documentation/docs/07-glossary/02-web.md
+++ b/documentation/docs/07-glossary/02-web.md
@@ -50,6 +50,12 @@ Le DOM relie les pages web aux scripts, fichiers de styles, ressources externes
 
 > Bientôt...
 
+## Language Server
+
+Un _language server_ est un algorithme exécuté par un <span class="vo">[IDE](/docs/development#ide)</span>. Il permet d’exécuter les aides au développement (autocomplétion, accès rapide, liste des utilisations, etc.) adaptées à un langage de programmation. L'interface entre l'IDE et le _language server_ est défini par un protocole, le _Language Server Protocol_ (LSP).
+
+Plus d'infos sur le [site de la documentation du LSP](https://microsoft.github.io/language-server-protocol/). 
+
 ## Lazy loading
 
 > Bientôt...
diff --git a/documentation/docs/07-glossary/03-javascript.md b/documentation/docs/07-glossary/03-javascript.md
index c27bd2f895..6de75cfb00 100644
--- a/documentation/docs/07-glossary/03-javascript.md
+++ b/documentation/docs/07-glossary/03-javascript.md
@@ -98,7 +98,17 @@ Plus d'infos sur les valeurs _truthy_ sur [le site de MDN](https://developer.moz
 
 ## Generic
 
-> Bientôt...
+Un _generic_ est une notion en TypeScript qui permet de définir une variable au sein d'un type. Il a pour fonctionnalité première de permettre de propager un type au sein d'une méthode lorsque le type est variable. L'exemple le plus simple est la fonction identité :
+
+```typescript
+function identity<Type>(arg: Type): Type {
+	return arg;
+}
+```
+
+Dans ce cas précis, le paramètre `arg` pourra être de n'importe quel type, représenté par le _generic_ `Type`. Le retour de la méthode aura le même type que le paramètre.
+
+Plus d'infos sur les [generics sur le site TypeScript](https://www.typescriptlang.org/docs/handbook/2/generics.html).
 
 ## Inline
 
@@ -137,9 +147,12 @@ Pour en savoir plus sur la différence entre `null` et `undefined`, vous pouvez
 
 ## Polyfill
 
-> Bientôt...
+Un _polyfill_ est un bout de code (généralement en JavaScript sur le web) utilisé pour fournir des fonctionnalités récentes sur d'anciens navigateurs qui ne les supportent pas nativement.
 
+Plus d'infos sur les [polyfills sur le site MDN](https://developer.mozilla.org/fr/docs/Glossary/Polyfill).
 
 ## Shadow DOM
 
-> Bientôt...
+Un _shadow DOM_ (ou DOM fantôme) est un <span class='vo'>[DOM](/docs/web#dom)</span> dans le DOM. Il est monté via la méthode `element.attachShadow()` et a pour particularité d'être encapsulé, c'est-à-dire que sa structure de balisage est isolée, que son style est isolé et que son comportement est caché et séparé du reste de code de la page.
+
+Plus d'infos sur le [shadow DOM sur le site MDN](https://developer.mozilla.org/fr/docs/Web/API/Web_components/Using_shadow_DOM).
diff --git a/documentation/docs/07-glossary/04-sveltejs.md b/documentation/docs/07-glossary/04-sveltejs.md
index e96ae1af76..950ca1c676 100644
--- a/documentation/docs/07-glossary/04-sveltejs.md
+++ b/documentation/docs/07-glossary/04-sveltejs.md
@@ -39,17 +39,31 @@ De la même manière, il est possible de _binder_ des propriétés d'un composan
 
 Il est également possible de _binder_ des propriétés de certains éléments du <span class='vo'>[DOM](/docs/web#dom)</span> (les éléments de type bloc, les images, les vidéo, window via `svelte:window` et document via `svelte:document`).
 
-## Hook
+## Props
 
-> Bientôt...
+Les _props_ ou propriétés sont les valeurs passées aux composants. Les props sont définies avec le mot clé `export` au sein du `script` des composants :
 
-## Props
+```sv
+<script>
+    export let value;
+</script>
+```
 
-> Bientôt...
+Elles sont passées au composant de la même manière qu'un attribut HTML :
+
+```svelte
+<Widget value="salut" />
+```
+
+Plus d'infos sur les [props dans la documentation](/docs/basic-markup#attributs-et-props).
+
+> Le concept de props est exactement le même en Svelte qu'en React, Vue ou Solid.
 
 ## Slot
 
-> Bientôt...
+Un _slot_ correspond au contenu enfant d'un composant. Il est possible d'y accéder dans le markup via `<slot>` ou dans le bloc `script` via la variable globale `$$slots`. 
+
+Plus d'infos sur [les slots dans la documentation](/docs/special-elements#slot).
 
 ## Store
 
@@ -57,10 +71,10 @@ Un _store_ est un concept au sein de Svelte qui permet de stocker une valeur, et
 
 Plus d'infos sur [les stores Svelte dans la documentation](/docs/svelte-store).
 
-## Svelte Language Server
+## Tick
 
-> Bientôt...
+De manière générale, un _tick_ peut faire référence à une période de temps unitaire. 
 
-## Tick
+Dans le cadre de Svelte, la méthode _tick_ définit est une promesse qui se résout une fois que tous les changements d'état en attente ont été appliqués, ou dans la micro-tâche suivante s'il n'y en a pas.
 
-> Bientôt...
+Plus d'infos sur [les ticks Svelte dans la documentation](/docs/svelte#tick).