Skip to content

Commit caab514

Browse files
EnnorielbleucitronRomain Crestey
committed
Add dev glossary entries (#38)
* Add dev glossary entries * Apply suggestions from code review Co-authored-by: Romain l'Ourson <[email protected]> * fix: kit link --------- Co-authored-by: Romain l'Ourson <[email protected]> Co-authored-by: Romain Crestey <[email protected]>
1 parent 0a2dd28 commit caab514

File tree

2 files changed

+20
-8
lines changed

2 files changed

+20
-8
lines changed

documentation/docs/04-compiler-and-api/01-svelte-compiler.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ Référez-vous à la section [CompilerResult](#types-compileresult) pour une des
5353

5454
> EXPORT_SNIPPET: svelte/compiler#parse
5555
56-
La méthode `parse` convertit un composant pour retourner son arbre syntaxique abstrait (<span class="vo">[AST](/docs/development#ast)</span>). Contrairement à la compilation avec l'option `generate: false`, aucune validation ni analyse n'est effectuée. Notez que l'AST n'est pas considéré comme une <span class="vo">[API](/docs/development#api)</span> publique ; des changements critiques pourraient survenir à n'importe quel moment.
56+
La méthode `parse` convertit un composant pour retourner son arbre de la syntaxe abstraite (<span class="vo">[AST](/docs/development#ast)</span>). Contrairement à la compilation avec l'option `generate: false`, aucune validation ni analyse n'est effectuée. Notez que l'AST n'est pas considéré comme une <span class="vo">[API](/docs/development#api)</span> publique ; des changements critiques pourraient survenir à n'importe quel moment.
5757

5858
```js
5959
// @filename: ambient.d.ts

documentation/docs/07-glossary/01-development.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,25 @@
22
title: 'Développement'
33
---
44

5-
Voici quelques informations sur les angliscismes usuels utilisés dans un contexte de développement informatique.
5+
Voici quelques informations sur les anglicismes usuels utilisés dans un contexte de développement informatique.
66

77
Ces mots n'ont pas de réelle traduction en français, ou alors celle-ci n'est que très rarement utilisée. Nous préférons donc laisser leur version anglaise dans la documentation pour rester au plus près de l'usage courant.
88

99
> Cette section de glossaire est spécifique à la documentation française de Svelte, et n'existe pas dans la documentation officielle.
1010
1111
## API
1212

13-
> Bientôt...
13+
Une API est une interface de programmation d'application. Il s'agit d'un ensemble de **points d'accès** publics ou privés basés sur le protocol HTTP et qui répondent des données, généralement exprimé en JSON.
14+
15+
Une API peut suivre une architecture logicielle particulière. Les plus connues sont le REST (_Representational State Transfer_) ou le GraphQL (_Graph Query Language_).
16+
17+
Dans le cadre de SvelteKit, il est possible de [définir une API publique](https://kit.svelte.dev/docs/routing#server) en définissant un fichier `+server.js` dans le dossier `routes`.
1418

1519
## AST
1620

17-
> Bientôt...
21+
Un arbre de la syntaxe abstraite (_Abstract Syntax Tree_ ou _AST_) est un format de représentation de certains données sous forme d'arbre dont les nœuds internes et les feuilles (ou nœuds externes) possèdent des caractéristiques particulières.
22+
23+
Svelte utilise le format _AST_ comme intermédiaire entre un composant Svelte et le code JavaScript natif interprété par le navigateur web.
1824

1925
## Build
2026

@@ -43,7 +49,11 @@ chargeLaDonnée(afficheCoucou);
4349

4450
## End to end
4551

46-
> Bientôt...
52+
L'adjectif bout en bout (_end to end_) s'applique à un processus qui soit complet (en opposition avec un processus unitaire).
53+
54+
Il s'applique généralement aux tests _end to end_ qui permettent de tester l'ensemble de l'application (IHM et serveur) sans simuler tout ou partie du système.
55+
56+
Dans le cadre de SvelteKit, il fait également référence au typage _end to end_, permettant de récupérer les types des données retournées par les méthodes `load()` des `layout` et des `routes` dans la variable `data` de la route correspondante.
4757

4858
## Getter / Setter
4959

@@ -74,15 +84,17 @@ Vous trouverez plus de détails sur les [getters](https://developer.mozilla.org/
7484

7585
## Hash
7686

77-
> Bientôt...
87+
Un _hash_ est le résultat d'une fonction de hachage (ou _hashing_). Une fonction de hachage est une fonction qui associe des valeurs de taille fixe à des données de taille arbitraire. Les _hash_ ont la particularité d'être statistiquement uniques, leur permettant d'être utilisés dans des applications d'indexation (pour une donnée, un hash unique est calculé et est stockée dans une table d'indexation).
88+
89+
Dans le cadre de Svelte, les _hash_ sont utilisés pour générer les noms de classes CSS.
7890

7991
## IDE
8092

81-
> Bientôt...
93+
Un environnement de développement intégré (_Integrated Development Environment) est un logiciel intégrant plusieurs outils facilitant le développement informatique. Parmi les plus célèbres dans le monde web: VSCode et WebStorm.
8294

8395
## Intellisense
8496

85-
> Bientôt...
97+
Le terme _intelliSense_ fait référence à des aides à la saisie semi-automatique de code qui comprend un certain nombre de fonctionnalités : autocomplétion, liste des propriétés, etc. Ces outils peuvent être intégré aux <span class="vo">[IDE](/docs/development#ide)</span> ou ajouté via des <span class="vo">[plugins](/docs/development#plugin)</span>. Il sont dépendants du langage de programmation et peuvent souvent être fortement configurés.
8698

8799
## Issue
88100

0 commit comments

Comments
 (0)