Merge pull request #318 from dnum-mi/docs/improve-intro-docs

docs: 📝 Améliore la documentation d’introduction

Author: laruiss

src/stories/docs/01-intro.stories.mdx

@@ -14,11 +14,14 @@ en [**Vue 3**](https://v3.vuejs.org/) sous forme de **bibliothèque de composant
 
 Pour commencer à l’utiliser, [c’est par ici !](/story/docs-2-guide-d-utilisation--page)
 
-# Qui sont les acteurs du projet
+# Les acteurs du projet
 
 - **Clément Debroize** [<img src={MailIcon} style={{height: '1.25rem', 'position': 'relative', top: '0.25rem' }} />](mailto:[email protected]) [<img src={GithubIcon} style={{height: '1.25rem', 'position': 'relative', top: '0.25rem' }} />](https://github.com/DaBadBunny)
 - **Pierre-Louis Egaud** [<img src={MailIcon} style={{height: '1.25rem', 'position': 'relative', top: '0.25rem' }} />](mailto:[email protected]) [<img src={GithubIcon} style={{height: '1.25rem', 'position': 'relative', top: '0.25rem' }} />](https://github.com/plegaud)
-- **Stanislas Ormières** [<img src={MailIcon} style={{height: '1.25rem', 'position': 'relative', top: '0.25rem' }} />](mailto:[email protected]) [<img src={GithubIcon} style={{height: '1.25rem', 'position': 'relative', top: '0.25rem' }} />](https://github.com/laruiss)
+- **Stanislas Ormières** [<img src={MailIcon} style={{height: '1.25rem', 'position': 'relative', top: '0.25rem' }} />](mailto:[email protected]) [<img src={GithubIcon} style={{height: '1.25rem', 'position': 'relative', top: '0.25rem' }} />](https://github.com/laruiss) *(Lead dev, architecte, devops)*
+
+Le projet a pu bénéficier des retours et de contributions de
+[Gildéric Deruette](https://github.com/gideruette) et [Sophie Aitis](https://github.com/sophieaitis)
 
 # Pourquoi VueDsfr
 
@@ -27,24 +30,26 @@ Vue 3. Le Système de design français (DSFR) est développé en JavaScript nati
 
 Le BRR a donc besoin d'un portage en Vue 3 de ce DSFR pour ses futurs projets qui devront le respecter.
 
-# Quels sont les principes et les buts de VueDsfr
+# VueDsfr en quelques mots
 
 Ce projet de bibliothèque de composants
 
-- doit être fait avec Vue 3
-- doit être utilisable facilement en tant que plugin
-- doit être utilisable facilement dans un projet npm
-- doit mettre à disposition deux types de documentation :
-  - une pour aider au développement
-  - une autre pour l'utilisation
-- doit publier un site complet avec les composants et leurs variants testables dans celui-ci dans un storybook
-- doit avoir un site déployé avec ce storybook disponible pour tous
-- doit avoir une couverture de test minimale
-- doit contenir le moins de CSS global possible et le CSS scopé inclus dans les composants
-- doit mettre à disposition les composants individuellement sans avoir à importer toute la bibliothèque
+- reproduit le plus fidèlement possible les composants du [DSFR](https://www.systeme-de-design.gouv.fr/)
+- est fait avec [Vue 3](https://vuejs.org)
+- est utilisable facilement en tant que plugin Vue 3
+- exporte les types (TypeScript) du plugin, des composants et des composables
+- est utilisable facilement dans un projet [npm](https://www.npmjs.com/package/@laruiss/vue-dsfr)
+- met à disposition deux parties dans la documentation :
+  - une pour [aider au développement](/?path=/story/docs-3-guide-du-développeur--page)
+  - une autre pour l'[utilisation](/?path=/story/docs-2-guide-d-utilisation--page)
+- publie un [site complet](vue-dsfr.netlify.app/) avec les composants et leurs variants testables dans celui-ci dans un storybook
+- déploie un site avec ce storybook disponible pour tous
+- a une couverture de test optimale
+- contient le CSS global du DSFR et (rarement) du CSS scopé inclus dans les composants
+- met à disposition les composants individuellement sans avoir à importer toute la bibliothèque
   (pour les petits projets)
 
-# Quels sont les choix techniques retenus
+# Les choix techniques retenus
 
 La bibliothèque est faite avec [Vue 3](https://v3.vuejs.org/) et [Vue-router 4](https://next.router.vuejs.org/).
 
@@ -57,13 +62,15 @@ Le serveur de développement est celui de [Storybook](https://storybook.js.org/)
 Storybook, et le site pour tester les composants est le storybook lui-même.
 
 Le CSS est écrit avec [PostCSS](https://postcss.org/) et notamment
-le plugin [postcss-preset-env](https://preset-env.cssdb.org/).
+le plugin [postcss-preset-env](https://preset-env.cssdb.org/) (mais très peu de CSS est propre à la bibliothèque).
 
 Storybook est configuré pour utiliser PostCSS.
 
-Les tests sont faits avec [Jest](https://jestjs.io) et [Vue Testing Library](https://testing-library.com/docs/vue-testing-library/intro/),
-et dans un futur proche avec [Cypress](https://www.cypress.io/).
+Les tests sont faits avec [Vitest](https://vitest.dev) et [Vue Testing Library](https://testing-library.com/docs/vue-testing-library/intro/),
+et des tests d’accessibilité sont faits avec [Cypress](https://www.cypress.io/) grâce aux
+[tests de composants](https://docs.cypress.io/guides/component-testing/introduction).
 
 Les icônes sont toujours celles de [RemixIcon](https://remixicon.com/), grâce à [Oh, Vue Icons!](https://github.com/Renovamen/oh-vue-icons/)
+(qui permet d’ajouter d’[autres icônes](/?path=/story/fondamentaux-4-1-icônes-personnalisées--page))
 
 La bibliothèque est compilée avec [Rollup](https://rollupjs.org/).