Commit 30b95dc2 authored by Viktor Jarry's avatar Viktor Jarry

relecture et correctifs sur le contenu

parent 3335a15d
......@@ -11,7 +11,7 @@ Des explications pratiques sont disponibles dans les pages suivantes.
### Partage de documents existants
De nombreux organismes ont documenté le SNDS pour des besoins internes.
Ce travail n'est souvent pas accessibles à la communauté plus large des utilisateurs du SNDS.
Ce travail n'est souvent pas accessible à la communauté plus large des utilisateurs du SNDS.
Une première contribution de grande valeur consiste à partager publiquement des documents existants.
**Où publier ces documents ?**
......@@ -47,11 +47,13 @@ La documentation du SNDS est éclatée dans de multiples fichiers, sous des form
Cette disparité complexifie l'exploration des informations,
et rend surtout impossible une collaboration large sur l'amélioration du contenu.
Ce site internet est rédigé en texte brut.
Ce site internet est rédigé à l'aide de fichiers textes type markdown. Un fichier markdown est balisé à l'aide de caractères spéciaux.
Pour en savoir plus se référer au [Tutoriel Markdown](/contribuer/tutoriel_markdown.md)
Une excellente contribution consiste à créer de nouvelles pages de documentation,
à partir de vos connaissances ou à partir du contenu de fichiers déjà partagés par ailleurs.
Nous organiserons progressivement les pages ainsi crées selon des thématiques cohérentes.
Nous organiserons progressivement les pages ainsi créées selon des thématiques cohérentes.
## Comment contribuer ?
......@@ -70,8 +72,8 @@ Nous nous chargerons alors d'intégrer votre contribution.
En créant un compte sur gitlab.com, vous pourrez utiliser le système de tickets appelés **issues**, dans cet
[onglet](https://gitlab.com/healthdatahub/documentation-snds/issues).
Les issues sont le canal à privilégier pour remonter une erreur ou proposer une idée.
Chaque issue est l'occasion d'une discussion ouverte pour résoudre le problème évoqué.
Les **issues** sont le canal à privilégier pour remonter une erreur ou proposer une idée.
Chaque **issue** représente une opportunité de discussion ouverte pour résoudre le problème évoqué de manière collaborative. Tout le monde est en capacité d'y participer.
### Merge-Request
......
......@@ -15,7 +15,7 @@ Nous présentons ici une introduction à GitLab pour les autodidactes.
La mise en forme du texte brut est indiquée avec des balises **Markdown**.
Ce texte est alors automatiquement mis sous la forme d'un site internet statique avec VuePress.
Se référer au [tutoriel Markdown](tutoriel_markdown.md) pour plus de détails.
Se référer au [Tutoriel Markdown](tutoriel_markdown.md) pour plus de détails.
## Concepts clés de git et GitLab
......@@ -33,7 +33,7 @@ Les branches de travail sont nommées selon l'objet des modifications apportées
- `merge-request` : Les merge-request (MR) permettent d'intégrer une branche de travail dans la branche principale.
Les modifications proposée dans la branche de travail sont discutées et validées avant d'être publiées.
Les modifications proposées dans la branche de travail sont discutées et validées avant d'être publiées.
Pour cela, les relecteurs commentent la MR dans l'onglet *Discussion*, ou font des remarques ligne par ligne dans l'onglet *Changes*.
Par défaut, seul l'auteur initial d'une branche en modifie le contenu, afin d'éviter des conflits d'édition.
......@@ -97,7 +97,7 @@ Une page s'ouvre alors pour configurer cette merge-request.
<img src="/assets/img/tutoriel_gitlab/wip.png" alt="wip" width="600"/>
</p>
### 4- Prévisualisation merge-request
### 4- Prévisualisation d'une merge-request
Lorsqu'une merge-request est ouverte, un "`pipeline`" est démarré pour construire une version de prévisualisation.
......
......@@ -5,7 +5,7 @@ L'ajout de nouveaux fichiers demande un peu d'attention. Ne pas hésiter à dema
## Nouvelle page du site
Les page du site internet sont des fichiers textuels, stockés dans le dossier [docs/documentation](https://gitlab.com/healthdatahub/documentation-snds/tree/master/docs/documentation).
Les pageq du site internet sont des fichiers textuels, stockés dans le dossier [docs/documentation](https://gitlab.com/healthdatahub/documentation-snds/tree/master/docs/documentation).
Pour créer une nouvelle page de documentation, copier le contenu du modèle présent dans le fichier [modele_markdown.md](https://gitlab.com/healthdatahub/documentation-snds/raw/master/docs/contribuer/modele_markdown.md).
......
......@@ -51,7 +51,7 @@ qui alimente le dictionnaire interactif, et la partie [table](/tables) de cette
[enregistement](https://www.youtube.com/watch?v=JpUbZUWwEt4)
- Schéma formel et Dictionnaire interactif du SNDS ([dico-snds.health-data-hub.fr](http://dico-snds.health-data-hub.fr/))
- Présenté par Matthieu Doutreligne et Vitkor Jarry de la DREES
- Présenté par Matthieu Doutreligne et Viktor Jarry de la DREES
- Support de présentation
[GSlides](https://docs.google.com/presentation/d/1XMGUJKcxy1zqfII-EtQDbmR2tljj6A8NIyEiEKJmz-Q/edit#slide=id.g54533cc6ad_0_0),
[pdf](/assets/src/presentations/meetup-snds1/2019.03.27_DREES_schema_dico_snds_MPL-2.0.pdf),
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment