update index page

Author: nriss

input/pagecontent/index.md

@@ -1,33 +1,26 @@
+Le guide d’implémentation est un support de publication des spécifications d’interopérabilité, combinant une documentation technique et une documentation narrative sous format web pour définir de manière précise comment sont échangées les données de santé. 
 
-Le guide d’implémentation est un support de publication des spécifications d’interopérabilité, combinant une documentation technique et une documentation narrative. Il n’est pas réservé aux seuls organismes de normalisation (comme InteropSanté ou l’ANS) : tout acteur peut en publier afin de rendre visibles ses spécifications, à condition qu’elles soient cohérentes avec l’écosystème français et compatibles avec les guides d’implémentation nationaux, notamment permis grâce au mécanisme d’héritage.
+### A qui est destiné cette documentation ?
+
+Cette documentation est séparée en trois parties afin d'adapter le discours à chaque profil :
 
-Ce guide d'implémentation "documentation" contient l'ensemble des bonnes pratiques de création de guides d'implémentation pour les FHIR modelers, ainsi que la documentation sur "comment lire un guide d'implémentation" pour un implémenteur.
+* Aux [professionnels de santé et établissements de santé](doc_ps.html), qui ont la vision métier et ont la capacité de challenger ces travaux.
+* Aux [FHIR modelers](dev_nouvel_ig.html), qui créent ces guides et profilent des ressources
+* Aux [FHIR implementers](demarrer_sur_fhir.html), qui lisent ces guides et développent des APIs
 
-L’objectif est d’encourager la participation de l’ensemble des parties prenantes. Bien qu’il existe déjà des publications versionnées, celles-ci ne sont pas définitives : elles restent ouvertes à l’évolution et peuvent être adaptées en fonction des contributions et des retours de l'ensemble des lecteurs.
+La création des guides d'implémentation n’est pas réservée aux seuls organismes de normalisation et de régulation (comme InteropSanté ou l’ANS) : tout acteur peut en publier afin de documenter ses interfaces, à condition qu’elles soient cohérentes avec l’écosystème français et compatibles avec les guides d’implémentation nationaux, notamment permis grâce au mécanisme d’héritage. L’objectif de ces guides est d’encourager la participation de l’ensemble des parties prenantes.
 
-### Les guides d'implémentation
+### L'intérêt des guides d'implémentation
 
-Un guide d'implémentation se présente sous forme d'un site web contenant un ensemble cohérent de ressources de conformité pour répondre à une problématique particulière. Le guide d'implémentation est versionné (l'ensemble des versions reste accessible) et packagé.
+Le guide d'implémentation est versionné (l'ensemble des versions reste accessible) et packagé. Une spécification n'est jamais figée : elles restent ouvertes à l’évolution et peuvent être adaptées en fonction des contributions et des retours de l'ensemble des lecteurs.
 
-La meilleure pratique consiste à créer un guide d'implémentation par projet bien spécifique, cela permet :
+Chaque guide d'implémentation est associé à un périmètre, à un cas d'usage, à un métier, ce qui permet permet :
 
-* De versionner séparément, on peut ainsi mettre à jour chacune des specs séparément sans avoir à mettre à jour celles qui ne sont pas concernées
-* Chacune des specs gère ses dépendances indépendamment des autres (aux ressources du ci-sis, aux profils interopsanté), chacune de ces dépendances peuvent être mises à jour séparément
+* De gérer les versions des guides de manière séparée : on peut ainsi mettre à jour chacune des specs séparément sans avoir à mettre à jour celles qui ne sont pas concernées
+* De gérer les dépendances indépendamment des autres guides : dépendances aux ressources du ci-sis, aux profils interopsanté, ...
 * Les urls sont claires, on sait directement de quelle spécification est issue chaque profil, et on peut directement accéder à l'IG en connaissant l'url canonique de l'IG
 * Les documentations génériques peuvent être surspécifiées pour réutiliser certains profils pour un autre cas d'usage, en héritant de tout ou partie, ou pour décrire une implémentation précise
-* L'IG doit obligatoirement hériter des profils FHIR réalisés par InteropSanté et/ou par l'ANS s'ils existent.
-
-Documentation : [ImplementationGuide](https://www.hl7.org/fhir/implementationguide.html), [Packages](https://confluence.hl7.org/display/FHIR/NPM+Package+Specification)
-
-### A qui est destiné cette documentation ?
-
-Il est destiné à celles et ceux qui utilisent FHIR :
-
-* Aux professionnels de santé et établissements de santé, qui ont la vision métier et ont la capacité de challenger ces travaux.
-* Aux FHIR modelers, qui créent ces guides et profilent des ressources
-* Aux FHIR implementers, qui lisent ces guides et développent des APIs
-
-Pour plus d'informations sur la modélisation ou l'implémentation FHIR, il suffit de naviguer au sein du menu de ci-dessus.
+* L'IG doit obligatoirement hériter des profils FHIR réalisés par InteropSanté et/ou par l'ANS (s'ils existent) pour être conforme au cadre national.
 
 ### La liste des guides d'implémentation de l'ANS
 
@@ -44,3 +37,8 @@ Un lien est également disponible sous chaque guide d'implémentation pour accé
 <img width="100%" alt="image" src="new_issue.png">
 
 L'issue doit contenir un titre, et une description la plus détaillée possible avec idéalement une proposition de changement pour faciliter et améliorer la qualité des modifications apportées.
+
+### Documentation
+
+* [ImplementationGuide](https://www.hl7.org/fhir/implementationguide.html)
+* [Packages](https://confluence.hl7.org/display/FHIR/NPM+Package+Specification)