Skip to content

Commit 9e69e17

Browse files
authored
Coquilles et améliorations typographiques (#549)
Relecture des bonnes pratiques 4xxx_fr.
1 parent da0920c commit 9e69e17

30 files changed

+118
-111
lines changed

README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ Pour simplifier vos recherches, n'oubliez pas d’utiliser les filtres disponibl
125125
* [Utiliser les compartiments CSS](/chapters/BP_4004_fr.md)
126126
* [Fournir une alternative textuelle aux contenus multimédias](/chapters/BP_4005_fr.md)
127127
* [Privilégier HTTP/2 à HTTP/1](/chapters/BP_4006_fr.md)
128-
* [Économiser de la bande passante grace à un ServiceWorker](/chapters/BP_4007_fr.md)
128+
* [Économiser de la bande passante grace à un Service Worker](/chapters/BP_4007_fr.md)
129129
* [Mettre en place un sitemap efficient](/chapters/BP_4008_fr.md)
130130
* [Assurer la compatibilité avec les plus anciens appareils et logiciels du parc](/chapters/BP_4009_fr.md)
131131
* [Réduire le volume de données stockées au strict nécessaire](/chapters/BP_4011_fr.md)

chapters/BP_4001_fr.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,8 @@
2424

2525
### Description
2626

27-
Les outils utilisés pour suivre les actions des utilisateurs utilisent souvent beaucoup de ressources coté client : requêtes
28-
nombreuses, fichiers javascript supplémentaires chargés, utilisation de plusieurs domaines additionnels, envoi de cookie, ...
27+
Les outils utilisés pour suivre les actions des utilisateurs utilisent souvent beaucoup de ressources côté client : requêtes
28+
nombreuses, fichiers JavaScript supplémentaires chargés, utilisation de plusieurs domaines additionnels, envoi de cookie, ...
2929

3030
Si les informations issues de ce suivi ne sont pas indispensables, ne pas en utiliser. Sinon se limiter à un seul outil et privilégier
3131
une solution qui consomme peu de ressources.

chapters/BP_4002_fr.md

-1
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,6 @@
2727
Le gif animé, format image animée datant de 1995, est plus lourd et plus lent que d'autres formats tels que les formats vidéo webm ou le mp4.
2828
Le webp animé est moindre dans son gain de poids et est actuellement peu supporté par les navigateurs.
2929

30-
3130
### Exemple
3231

3332
| | .gif (animé) | .webp (animé) |.webm | .mp4 |

chapters/BP_4003_fr.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -35,13 +35,13 @@ Il convient alors de forcer le navigateur à ne rien précharger en définissant
3535

3636
### Exemple
3737

38-
Vidéo:
38+
Vidéo :
3939

4040
```html
4141
<video src="fichiervideo.webm" preload="none"></video>
4242
```
4343

44-
Audio:
44+
Audio :
4545

4646
```html
4747
<audio controls src="fichieraudio.mp3" preload="none"></audio>
@@ -51,4 +51,4 @@ Audio:
5151

5252
| Le nombre ... | est inférieur ou égal à |
5353
|-------------------|:-------------------------:|
54-
| d'éléments `<vidéo>` ou `<audio>` sans un attribut `preload="none"` ou `autoplay` | 0 |
54+
| d'éléments `<video>` ou `<audio>` sans un attribut `preload="none"` ou `autoplay` | 0 |

chapters/BP_4004_fr.md

+6-4
Original file line numberDiff line numberDiff line change
@@ -27,22 +27,24 @@
2727
Le CSS Containment (ou compartimentation CSS) indique qu'un nœud et son contenu sont, autant que possible, indépendants du reste de l'arborescence de la page.
2828

2929
En fonction du type d'indépendance (```strict```, ```content```, ```size```, ```layout```, ```style``` et/ou ```paint```) de la propriété ```contain```, le navigateur :
30-
- recalcule le rendu (les positions, la mise en forme, les dispositions et/ou l'affichage) pour le seul nœud indépendant économisant ainsi, de recalculer l’entièreté du DOM de la page
31-
- ne fait pas le rendu du contenu des nœuds indépendants hors zone visible
30+
- recalcule le rendu (les positions, la mise en forme, les dispositions et/ou l'affichage) pour le seul nœud indépendant, économisant ainsi de recalculer l’entièreté du DOM de la page ;
31+
- ne fait pas le rendu du contenu des nœuds indépendants hors zone visible.
3232

3333
### Exemples
34-
- Une architecture DOM complexe dont le contenu de noeuds est modifié à un moment donné
34+
35+
- Une architecture DOM complexe dont le contenu de nœuds est modifié à un moment donné :
3536
```css
3637
article {
3738
contain: content;
3839
}
3940
```
40-
- Un widget externe
41+
- Un widget externe :
4142
```css
4243
.widget-name {
4344
contain: layout;
4445
}
4546
```
47+
4648
Pour aller plus loin :
4749
- [https://developer.mozilla.org/fr/docs/Web/CSS/CSS_Containment](https://developer.mozilla.org/fr/docs/Web/CSS/CSS_Containment)
4850
- [https://www.w3.org/TR/css-contain-2/](https://www.w3.org/TR/css-contain-2/)

chapters/BP_4005_fr.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -26,17 +26,17 @@
2626

2727
Le texte, même mis en forme en HTML/CSS, utilise beaucoup moins de bande passante que des formats multimédias comme l'audio ou la vidéo.
2828
Fournir aux utilisateurs une alternative textuelle à ces contenus leur permet s'ils le souhaitent de lire plutôt que d'écouter ou de visionner, et donc de transférer moins de données.
29-
Si cette alternative textuelle a elle même une taille importante, elle peut ne pas être chargée par défaut mais suite à une action utilisateur.
29+
Si cette alternative textuelle a elle-même une taille importante, elle peut ne pas être chargée par défaut mais suite à une action utilisateur.
3030

31-
Cette pratique est également bénéfique pour l'accessibilité : les mal entendants pourront lire le contenu et y auront donc accès, de même pour les mal voyants, si le texte inclut une description des éléments des vidéos qui ne sont que visibles.
31+
Cette pratique est également bénéfique pour l'accessibilité : les malentendants pourront lire le contenu et y auront donc accès, de même pour les malvoyants, si le texte inclut une description des éléments des vidéos qui ne sont que visibles.
3232

3333
Cette pratique est également bénéfique pour le référencement, les moteurs de recherche pouvant plus facilement analyser le texte que l'audio et la vidéo.
3434

35-
Voir aussi sur le même sujet la pratique « Eviter la lecture automatique des vidéos et des sons »
35+
Voir aussi sur le même sujet la [bonne pratique « Éviter la lecture et le chargement automatique des vidéos et des sons »](/chapters/BP_4003_fr.md).
3636

3737
### Exemple
3838

39-
Une video de 30 minutes va typiquement faire 500mo, un podcast de la même durée fera 30mo, et l'équivalent texte moins d'1 mo.
39+
Une vidéo de 30 minutes va typiquement faire 500 Mo, un podcast de la même durée fera 30 Mo, et l'équivalent texte moins d'1 Mo.
4040

4141
### Principe de validation
4242

chapters/BP_4007_fr.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
## Économiser de la bande passante grace à un ServiceWorker
1+
## Économiser de la bande passante grâce à un Service Worker
22

33
### Identifiants
44

@@ -48,7 +48,7 @@ On concède ici un peu de temps processeur dans le terminal,
4848
une requête initiale supplémentaire pour le Service Worker,
4949
puis deux requêtes supplémentaires pour l'entête et le pied de page,
5050
contre de grosses économies dans les quantités de données échangées pour chaque page.
51-
Ces coûts concédés sont amortis lors de navigations dans le site (comme pour une SPA),
51+
Ces coûts concédés sont amortis lors de navigations dans le site, comme pour une SPA (Single Page Application),
5252
mais également lors de prochaines visites du site,
5353
tant que le navigateur n'aura pas évincé le Service Worker.
5454

@@ -58,7 +58,7 @@ Début 2020, Philip Walton a pu mesurer sur son blog une réduction des échange
5858
et une amélioration des performances (First Contentful Paint) de plus de 52%
5959
avec cette technique.
6060

61-
Source: https://philipwalton.com/articles/smaller-html-payloads-with-service-workers/
61+
Source : https://philipwalton.com/articles/smaller-html-payloads-with-service-workers/
6262

6363
### Principe de validation
6464

chapters/BP_4008_fr.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
### Description
2626

2727
Le sitemap (plan du site) permet de faciliter l'indexation des pages et des contenus d'un site web par les moteurs de recherche.
28-
Un sitemap non mis à jour peut contenir des urls qui n'ont plus raison d'y être car elles font référence à des pages ou des contenus peu visités et peu utiles.
28+
Un sitemap non mis à jour peut contenir des URLs qui n'ont plus raison d'y être car elles font référence à des pages ou des contenus peu visités et peu utiles.
2929
Une telle situation augmente le risque d'avoir des internautes qui arrivent sur des pages sans intérêt via les moteurs de recherche ou même des pages orphelines.
3030
Ainsi, l'internaute risque de solliciter des ressources informatiques pour rien.
3131

chapters/BP_4009_fr.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -24,14 +24,14 @@
2424

2525
### Description
2626

27-
Il faut s'assurer de la compatibilité du site avec les plus anciens matériels et logiciels que les utilisateurs peuvent possèder.
27+
Il faut s'assurer de la compatibilité du site avec les plus anciens matériels et logiciels que les utilisateurs peuvent posséder.
2828
Les pages doivent être utilisables sur les configurations les plus contraignantes : pas de mises en page cassées, de boutons inactifs,
2929
d'erreurs affichées ou autre problème empêchant la lecture ou la navigation.
3030

3131
Les configurations les plus contraignantes à choisir comprennent :
32-
- Les versions de navigateurs les plus anciennes, ou qui posent le plus de problèmes de compatibilités ;
33-
- Les versions d'OS les plus anciennes ;
34-
- Les terminaux les moins puissants que les utilisateurs possèdent : smartphones, ordinateurs ou autres.
32+
- les versions de navigateurs les plus anciennes, ou qui posent le plus de problèmes de compatibilités ;
33+
- les versions d'OS les plus anciennes ;
34+
- les terminaux les moins puissants que les utilisateurs possèdent : smartphones, ordinateurs ou autres.
3535

3636
Le choix des configurations va dépendre de l'état du web au moment de l'implémentation de la solution, ainsi que du contexte
3737
projet : des publics différents amèneront des contraintes différentes.
@@ -42,7 +42,7 @@ est de faire une étude sur le terrain des utilisateurs et de leurs équipements
4242

4343
### Exemple
4444

45-
Pour différentes raisons (machines trop anciennes pour être mise à jour, manque d'un accès administrateur au système ou
45+
Pour différentes raisons (machines trop anciennes pour être mises à jour, manque d'un accès administrateur au système ou
4646
méconnaissance de l'existence d'alternatives), des utilisateurs sont bloqués sur Internet Explorer.
4747
Un site développé pour des navigateurs modernes, utilisant par exemple massivement _flexbox_ ou _css grid_ ne s'affichera
4848
pas correctement sur ce navigateur.

chapters/BP_4011_fr.md

+8-6
Original file line numberDiff line numberDiff line change
@@ -23,10 +23,11 @@
2323
| Stockage |
2424

2525
### Description
26-
Réduire le volume de données stockées au nécessaire consiste à :
27-
* optimiser la gestion des gros volumes de données.
28-
* nettoyer les anciennes données, soit en les archivant hors ligne, soit en les supprimant.
29-
* vérifier que les sauvegardes peuvent être restaurées.
26+
27+
Réduire le volume de données stockées au strict nécessaire consiste à :
28+
* optimiser la gestion des gros volumes de données ;
29+
* nettoyer les anciennes données, soit en les archivant hors ligne, soit en les supprimant ;
30+
* vérifier que les sauvegardes peuvent être restaurées ;
3031
* superviser la taille des espaces de stockage.
3132

3233
Suivant le type de données et leurs propriétaires, des contraintes légales peuvent amener à stocker dans le temps des données jamais utilisées.
@@ -36,9 +37,10 @@ L’utilisation des données et leur degré d’importance impactent aussi la ma
3637
Cette bonne pratique s'inscrit dans le cadre de la gestion du cycle de vie de l'information.
3738

3839
### Exemple
40+
3941
* Définir des processus d'archivage : au moment de sa sortie, un rapport annuel est stocké sur un SSD (zone chaude). Un mois plus tard, il est archivé sur un stockage classique (zone froide). Enfin, dix ans plus tard, il est supprimé.
40-
* Eviter les doublons entre les tables est un moyen d’optimiser le volume de données stockées.
41-
* L’utilisation des données peut conduire à une dénormalisation des tables et donc une augmentation de l’espace de stockage.
42+
* Éviter les doublons entre les tables est un moyen d’optimiser le volume de données stockées.
43+
* L’utilisation des données peut conduire à une dénormalisation des tables et donc à une augmentation de l’espace de stockage.
4244

4345
### Principe de validation
4446

chapters/BP_4012_fr.md

+7-5
Original file line numberDiff line numberDiff line change
@@ -23,17 +23,19 @@
2323
| Stockage / Requêtes |
2424

2525
### Description
26+
2627
Depuis la mise en place du RGPD par la CNIL, il est obligatoire de supprimer les données personnelles d'un utilisateur
2728
après une durée définie d'après plusieurs conditions. Il est obligatoire de le faire sur les données personnelles de nos
2829
utilisateurs, mais nous pouvons également définir une durée de vie pour toute autre donnée. Heureusement, organiser la
2930
durée de vie de nos données peut être effectué de manière automatique, sans avoir à purger manuellement les données obsolètes.
3031

31-
De nombreux systèmes de gestion de bases de données, comme `MongoDB` , `AWS DynamoDB`, `Redis` ou `Oracle` permettent de
32+
De nombreux systèmes de gestion de bases de données, comme `MongoDB`, `AWS DynamoDB`, `Redis` ou `Oracle` permettent de
3233
définir un "TTL" sur une table ou sur une donnée.
3334
Après avoir défini une durée de vie, les données expirées sont purgées et effacées définitivement de la base.
3435

3536
### Exemple
36-
Dans cet exemple en Java, sur une base Oracle, la durée de vie de la donnée expirera au bout de 5 jours
37+
38+
Dans cet exemple en Java, sur une base Oracle, la durée de vie de la donnée expirera au bout de 5 jours :
3739
```java
3840
String aKey = "myFirstKey";
3941
String aData = "myFirstData";
@@ -43,10 +45,10 @@ try {
4345
DatabaseEntry theData = new DatabaseEntry(aData.getBytes("UTF-8"));
4446

4547
WriteOptions wo = new WriteOptions();
46-
wo.setTTL(5); // TTL de 5 jours
47-
myDatabase.put(null, // Transaction
48+
wo.setTTL(5); // TTL de 5 jours.
49+
myDatabase.put(null, // Transaction.
4850
theKey, // Clé.
49-
theData, // valeur.
51+
theData, // Valeur.
5052
Put.NO_OVERWRITE,
5153
wo); // Options (incluant la durée de TTL).
5254

chapters/BP_4013_fr.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424

2525
### Description
2626

27-
L'élément HTML `canvas` est initialement conçu pour dessiner des graphiques, réaliser des jeux ou générer des images à la volée via des API JavaScript. Comme chaque script, l'utilisation de `canvas` a un impact significatif sur les besoins de ressources machines (CPU et/ou GPU) augmentant ainsi une mauvaise expérience utilisateur sur les machines les moins puissantes et entraînant également une surconsommation d'énergie.
27+
L'élément HTML `canvas` est initialement conçu pour dessiner des graphiques, réaliser des jeux ou générer des images à la volée via des API JavaScript. Comme chaque script, l'utilisation de `canvas` a un impact significatif sur les besoins de ressources machines (CPU et/ou GPU), augmentant ainsi une mauvaise expérience utilisateur sur les machines les moins puissantes et entraînant également une surconsommation d'énergie.
2828
Cet impact est plus important quand le rendu est réalisé de manière répétitive (effet dynamique, animation).
2929
Il est recommandé d'utiliser d'autres éléments HTML natifs quand cela est possible et à défaut de mettre en place des optimisations pour limiter les besoins en ressources machines.
3030

@@ -37,7 +37,7 @@ Il est recommandé d'utiliser d'autres éléments HTML natifs quand cela est pos
3737

3838
### Sources
3939

40-
- [Element canvas](https://www.w3.org/TR/2011/WD-html5-20110405/the-canvas-element.html)
40+
- [Élément canvas](https://www.w3.org/TR/2011/WD-html5-20110405/the-canvas-element.html)
4141
- [Optimiser les canvas](https://developer.mozilla.org/fr/docs/Web/API/Canvas_API/Tutorial/Optimizing_canvas)
4242

4343
### Principe de validation

chapters/BP_4014_fr.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,11 @@
2424

2525
### Description
2626

27-
Des services web permettent de réaliser sans se déplacer des démarches administratives, des ouvertures de contrats, des déclarations de sinistres etc...
27+
Des services web permettent de réaliser sans se déplacer des démarches administratives, des ouvertures de contrats, des déclarations de sinistres, etc.
2828
Beaucoup de ces procédures peuvent être complexes à réaliser ou ne pas prendre en compte des cas particuliers.
2929
Pour valider la connexion à un service bancaire en ligne par exemple, l'installation d'une application mobile et donc un smartphone peuvent être exigés.
3030
Certains utilisateurs peuvent donc se retrouver bloqués dans l'utilisation du service.
31-
La mise en place d'une alternative plus "low tech" (appel téléphonique, SMS, point d'accueil physique) peut pallier à cette situation.
31+
La mise en place d'une alternative plus "low tech" (appel téléphonique, SMS, point d'accueil physique) peut pallier cette situation.
3232

3333
### Exemple
3434

chapters/BP_4015_fr.md

+1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
## Avoir un titre de page et une metadescription pertinents avec le contenu de la page
2+
23
### Identifiants
34

45
| GreenIT | V2 | V3 | V4 |

chapters/BP_4017_fr.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ ou utilisée uniquement sous certaines conditions.
4141

4242
Éviter les chargements et mise en cache (ou en stockage local) de données applicatives,
4343
comme des listes des valeurs et autres référentiels,
44-
si on n'est pas absoluement certain qu'elles seront utilisées.
44+
si l'on n'est pas absolument certain qu'elles seront utilisées.
4545

4646
Par extension, découper le code JS, voire les CSS, par portions (_chunks_) relatives à des actions particulières de l'utilisateur,
4747
et ne charger ces portions que lorsqu'elles sont nécessaires.

chapters/BP_4018_fr.md

+5-4
Original file line numberDiff line numberDiff line change
@@ -25,19 +25,20 @@
2525
### Description
2626

2727
Éliminer les fonctionnalités non utilisées consiste à :
28-
* Mesurer l'utilisation des fonctionnalités en production.
29-
* Piloter l’usage des fonctionnalités, et à supprimer celles qui ne sont pas assez utilisées ou qui ont perdu de la valeur.
28+
* mesurer l'utilisation des fonctionnalités en production ;
29+
* piloter l'usage des fonctionnalités, et à supprimer celles qui ne sont pas assez utilisées ou qui ont perdu de la valeur.
3030

3131
Supprimer des fonctionnalités allège le poids de l’application, son impact en production et sa maintenance.
3232

3333
Comment supprimer une fonctionnalité ?
34-
* la désactiver : sur le principe du feature flipping, empêcher qu'elle soit utilisée avec un flag.
34+
* la désactiver : sur le principe du feature flipping, empêcher qu'elle soit utilisée avec un flag ;
3535
* la désinstaller : supprimer au maximum le code utilisé puis refactorer le code restant.
3636

37-
En fonction du coût environnemental et économique dune suppression, l'une ou l'autre solution sera retenue.
37+
En fonction du coût environnemental et économique d'une suppression, l'une ou l'autre solution sera retenue.
3838

3939

4040
### Exemple
41+
4142
Un site e-commerce utilise deux listes différentes : liste de courses et liste de favoris. Lors de la refonte du site, au lieu de rester iso-fonctionnel, l’équipe mesure la pertinence des fonctionnalités. La mesure montre que la liste de favoris est devenue désuète. Elle est donc supprimée ainsi que toutes les données en base.
4243

4344
Une page d’administration peut être utilisée une fois par an et être très importante (par exemple une purge de cache qui est utilisée uniquement en cas de mise à jour de référentiel). Dans ce cas, elle doit être conservée.

chapters/BP_4019_fr.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -25,17 +25,17 @@
2525
### Description
2626

2727
Lors de la conception d'un service numérique, il est indispensable de définir les supports nécessaires en fonction des utilisateurs.
28-
Un site internet responsive peut-être tout à fait suffisant et satisfaisant.
28+
Un site internet responsive peut tout à fait être suffisant et satisfaisant.
2929

3030
Cependant si une application mobile est strictement nécessaire et qu'elle reprend entièrement ou en partie le site internet, alors une PWA (Progressive Web App) est une solution évitant des doubles, voire des triples développements et maintenances qu'occasionnerait le développement d'une application mobile native ou hybride (React native, Flutter).
3131

32-
La PWA n'étant pas liée à un système d'exploitation (OS) et souvent plus légère qu'une application mobile native, permet de réduire le risque d'obsolescence du terminal mobile et une utilisation moindre de la bande passante. C'est ainsi que plusieurs réseaux sociaux ont développé une PWA pour conquérir des marchés avec des réseaux avec de faibles débits.
32+
N'étant pas liée à un système d'exploitation (OS) et souvent plus légère qu'une application mobile native, la PWA permet de réduire le risque d'obsolescence du terminal mobile et une utilisation moindre de la bande passante. C'est ainsi que plusieurs réseaux sociaux ont développé une PWA pour conquérir des marchés avec des réseaux avec de faibles débits.
3333

3434
### Exemple
3535

3636
- Des sites e-commerce (Lancôme, Starbucks, etc.)
3737
- Des médias (L'équipe, Courrier International, Forbes, etc.)
38-
- Des Software as a Service (Microsoft 365, Gmail, etc.)
38+
- Des solutions Software as a Service (Microsoft 365, Gmail, etc.)
3939
- Des réseaux sociaux (Twitter Lite, Telegram, etc.)
4040
- Des applications métiers (SNCF, etc.)
4141

0 commit comments

Comments
 (0)