Fix/review contributions

README.md

@@ -20,7 +20,7 @@ Les pages de documentation générale Jeedom sont directement accessibles sur ce
 
 ### Documentation du core
 
-La documentation relative au core Jeedom *(manuels d'utilisation et de configuration)* se trouve dans le dossier `docs/fr_FR` du dépôt du core : <https://github.com/jeedom/core/tree/alpha/docs/fr_FR>. La branche `alpha` est à privilégier pour les contributions.
+La documentation relative au core Jeedom *(manuels d'utilisation et de configuration)* se trouve dans le dossier `docs/fr_FR` du dépôt du core : <https://github.com/jeedom/core/tree/develop/docs/fr_FR>. La branche `develop` est à privilégier pour les contributions.
 
 ### Documentation des plugins
 
@@ -32,8 +32,8 @@ Comme pour le core Jeedom, la documentation des plugins officiels est automatiqu
 >
 >A lire impérativement avant toute intervention : [**Comment contribuer au développement du core Jeedom ?**](https://doc.jeedom.com/fr_FR/contribute/core)
 
-Tout comme la documentation, le core Jeedom est open source et ouvert aux contributions. L'intégralité du code est consultable à cette adresse : <https://github.com/jeedom/core/tree/alpha>.
-Sauf indication contraire, **les modifications doivent impérativement être soumises sur la branche `alpha`**.
+Tout comme la documentation, le core Jeedom est open source et ouvert aux contributions. L'intégralité du code est consultable à cette adresse : <https://github.com/jeedom/core/tree/develop>.
+Sauf indication contraire, **les modifications doivent impérativement être soumises sur la branche `develop`**.
 
 ------------
 
@@ -59,7 +59,7 @@ The general Jeedom documentation pages are directly accessible on this repositor
 
 ### Core documentation
 
-Documentation relative to the Jeedom core *(user and configuration manuals)* can be found in the folder `docs/fr_FR` from core repository : <https://github.com/jeedom/core/tree/alpha/docs/fr_FR>. The `alpha` branch is preferred for contributions.
+Documentation relative to the Jeedom core *(user and configuration manuals)* can be found in the folder `docs/fr_FR` from core repository : <https://github.com/jeedom/core/tree/develop/docs/fr_FR>. The `develop` branch is preferred for contributions.
 
 ### Plugins documentation
 
@@ -71,8 +71,8 @@ As with the Jeedom core, officials plugins documentations are automatically gene
 >
 >Must be read before any intervention : [**How to contribute to Jeedom core development ?**](https://doc.jeedom.com/en_US/contribute/core)
 
-Like documentation, the Jeedom core is open source and open to contributions. The complete code can be consulted at this address : <https://github.com/jeedom/core/tree/alpha>.
-Unless otherwise indicated, **modifications must be submitted on the `alpha` branch**.
+Like documentation, the Jeedom core is open source and open to contributions. The complete code can be consulted at this address : <https://github.com/jeedom/core/tree/develop>.
+Unless otherwise indicated, **modifications must be submitted on the `develop` branch**.
 
 ------------
 

fr_FR/beta/index.md

@@ -1,77 +1,119 @@
 
-## Beta et Alpha test de Jeedom
+# Bêta-test de Jeedom
 
-### Définition
+Un bêta‑testeur est un utilisateur qui teste les versions du logiciel avant qu'elles soient diffusées à l'ensemble des utilisateurs. Le bêta-testing permet de remonter des erreurs qui pourraient apparaitre lors de la phase de développement *(bug fonctionnel ou souci d'interface par exemple)*. C'est une importante source d'amélioration pour le projet, qui permet d'apporter des idées fraîches et de tester les nouveautés en conditions réelles.
 
-Un Beta Testeur est un utilisateur qui teste les versions du logiciel avant qu'elles ne soient diffusées à tous les utilisateurs. Le beta testing permet de remonter des erreurs (bug fonctionnel ou soucis d'interface utilisateur par exemple) lors de la phase de développement. C'est donc une importante source d'amélioration pour le projet, qui peut apporter des idées fraiches et tester les nouveautés en conditions réelles. 
+## Mises en garde
 
-### Précautions
+Bien que les développeurs prennent un maximum de précautions, les versions en cours de développement sont susceptibles d'inclure des bugs pouvant rendre un plugin ou le core totalement inopérants. De la même manière, les fonctionnalités en cours de développement peuvent être reportées, voire abandonnées en fonction des circonstances. Il faut donc être plutôt à l'aise avec les procédures de sauvegarde/restauration de Jeedom avant de se lancer dans le bêta-testing.
 
-Les versions **Beta** et **Alpha** du Core ou des plugins sont des versions de développement. Même si les développeurs prennent bien sûr des précautions, ces versions peuvent comprendre des bugs susceptibles de rendre un plugin ou le Core totalement inopérant. Il faut donc être familier des procédures de backup, récupération, etc.
+Comme indiqué ci-dessus, le fait de basculer Jeedom ou un plugin sur une version en cours de développement comporte des risques. Par conséquent, **il est fortement recommandé de le faire sur une installation de test prévue à cet effet *([une machine virtuelle](../installation/vm) par exemple)* plutôt que sur un Jeedom en production**.
 
-Le développement du Core se fait sur [Github](https://github.com/jeedom/core) sur la version **Alpha**. Celle-ci possède donc toutes les futures nouveautés, mais aussi le plus de bugs. De plus, les développements faits sur cette version sont susceptibles d'être annulés ou reportés. La version **Alpha** remonte ensuite en **Beta**, qui est généralement *Featured fixed* et consiste donc à s'assurer de sa stabilité, tout en permettant aux développeurs de plugins de tester leurs futures versions.
+>**IMPORTANT**
+>
+>L'équipe Jeedom ne peut être tenue responsable de tout dysfonctionnement survenant suite à l'installation d'une version autre que stable. Dans ce cas **l'accès au support officiel est impossible**, il faut donc [faire une remontée](#Faire%20une%20remontée).
 
-> **Important**
-> Le passage en beta (ou alpha) d'un plugin ou du Core est risqué et interdit tout accès au support officiel de l'équipe Jeedom. Les développeurs sont toutefois présents sur [Community](https://community.jeedom.com/) pour aider en cas de problème, sans garantie toutefois.
+## Branches
 
-> **Important**
-> Il est fortement déconseillé d'installer une beta ou alpha sur un Jeedom de production ! Il est indispensable de tester sur un Raspberry ou une VM de test et l'équipe Jeedom ne pourra être tenue pour responsable de tout dysfonctionnement.
+Jeedom est un logiciel open-source dont le développement peut être suivi en temps réel sur [GitHub](https://github.com/jeedom/core){:target="_blank"}. Chaque branche correspondant à différents niveaux d'avancement dans son développement.
 
-### Comment
+### Branches principales
 
-Le Core de Jeedom est Open-Source. Tout le monde peut décider de passer son Jeedom d'une version Stable à une version Beta ou Alpha, avec toutes les précautions nécessaires citées ci-dessus.
+-  **develop** : Version en cours de développement incluant des modifications régulières *(intégration continue)*.
+-  **release** : Prochaine version déployée quelques jours avant passage en stable.
+-  **master** : Version stable de Jeedom *(branche par défaut incluant le support officiel)*.
 
-Le Core possède trois branches principales sur [Github](https://github.com/jeedom/core):
+### Branches annexes
 
--  **alpha** : Branche de la version V4 alpha. Principalement destinée aux développeurs pour la version suivante de Jeedom.
--  **beta** : Branche de la version V4 beta. Principalement destinée aux beta testeurs, pour tester avant passage en Stable.
--  **master** : Branche stable de la V4.
+Les branches annexes correspondent à des développements indépendants et ponctuels, voués à être intégrés à une branche principale.
 
-> **Attention**
-> Encore une fois, cette manipulation est à réserver aux utilisateurs avancés en toute connaissance de cause.
+-  **feat/xxxxx-yyyyy** : Nouvelle fonctionnalité testable avant son déploiement dans `develop`.
+-  **fix/xxxxx-yyyyy** :  Correctif non urgent testable quelques jours avant son déploiement dans `develop`.
+-  **hotfix/xxxxx-yyyyy** : Correctif urgent rapidement déployé dans `master` & `develop`.
 
-> **Attention**
-> Le *downgrade* de version est totalement déconseillé et peut rendre Jeedom totalement inopérant. Par exemple, *downgrader* de Beta v4.2 vers Stable v4.1 ne doit pas être fait ! Dans ce cas, la meilleure solution est d'attendre la future version Stable de l'actuelle Beta, puis remettre la configuration de Jeedom en version Stable, et faire une mise à jour manuelle. De même un backup d'une version ultérieure ne doit pas être restauré sur une version antérieure (par exemple backup 4.2 sur Core 4.1).
+>**INFORMATION**
+>
+>`xxxxx-yyyyy` correspond au sujet court de la fonctionnalité ou du correctif en question.
 
-Pour changer de version, rendez vous dans *Réglages → Système → Configuration*, onglet *Mises à jour/Market*. Laissez la Source de mise à jour à **Défaut** et choisissez la version que vous souhaitez.
+### Changer de version
 
-Ensuite, sauvegardez puis rendez vous dans *Réglages → Système → Centre de Mise à jour*. Ici lancez une mise à jour du Core.
+A la lecture des [mises en garde](#Mises%20en%20garde) exposées précédemment, il est évident que **cette manipulation est à réserver aux utilisateurs avancés en toute connaissance de cause**.
 
-### Feedbacks
+Pour changer de branche, et donc de version Jeedom, rendez-vous dans le menu **Réglages → Système → Configuration**, onglet **Mises à jour/Market**. Laissez la source de mise à jour sur **Défaut** et sélectionnez la version du core *(branche)* que vous souhaitez installer.
 
-Le but d'un beta testeur est de remonter les soucis rencontrés lors de ses tests.
-Ces remontées se font sur **[Community](https://community.jeedom.com/)** dans la section **[beta-testeurs](https://community.jeedom.com/c/salon-des-beta-testeurs/6)**
+Ensuite, cliquez sur le bouton **Sauvegarder** puis dirigez-vous vers le menu **Réglages → Système → Centre de Mise à jour**. Depuis cette page il ne reste qu'à effectuer une mise à jour du core pour basculer sur la nouvelle version.
 
-C'est aussi sur cette section qu'un testeur peut créer un sujet pour proposer une amélioration.
+>**IMPORTANT**
+>
+>En cas de changement de numérotation du core, il est vivement déconseillé de revenir sur une version inférieure *(downgrade)*. Il est plutôt recommandé d'attendre que les modifications arrivent en version stable pour rebasculer dessus.\
+>Concernant les branches annexes, une fois la fonctionnalité ou le correctif testés, il faut revenir sur la version à la base *(`develop` dans la majorité des cas)*.
 
-> Chaque sujet sur cette section doit être identifié avec le tag de la version en cours de développement. Par exemple : tag v4_4 (un underscore est utilisé car les points sont interdits dans les tags sur Discourse.
+## Mises à jour
 
-Cette section n'est pas accessible publiquement. Pour y avoir accès, vous devez remplir un formulaire afin que l'équipe Jeedom donne [accès à votre compte](https://blog.jeedom.com/jeedom-partenaire-beta-testeur/).
+En `master` *(stable)* ou `release`, chaque nouvelle version entraine un changement de numérotation *(x.y.z)*. Si la case **Vérification automatique des mises à jour** est cochée, alors un message de notification sera émis dans Jeedom accompagné d'une pastille rouge dans la barre de menu. Sinon il faut se rendre dans le menu **Réglages → Système → Centre de Mise à jour** puis cliquer sur le bouton **Vérifier les mises à jour**.
 
-> Avant de remonter un problème, mettez à jour le Core et réessayez de reproduire. Voir ci-dessous.
+À l'inverse, les autres branches n'engendrent pas de notification ni d'alerte dans le centre de mises à jour malgré des modifications régulières. Il revient donc au bêta‑testeur de mettre le core à jour manuellement et régulièrement. Avant chaque phase de tests notamment, et surtout, avant d'effectuer toute remontée afin de s'assurer que le problème n'a pas déjà été corrigé.
 
-### Gestion des mises à jour du Core
+## Changelog
 
-En version **Stable**, chaque changement provoque un changement de version (mineure, par exemple 4.1.xx) qui, si vous avez coché **Vérification automatique des mises à jour**, provoquera un message et l’apparition de la pastille rouge dans la barre de menu. Ces mises à jour sont également affichées dans *Réglages → Système → Centre de Mise à jour* en cliquant manuellement sur *Vérifier les mises à jour*.
+Le **journal des modifications** *(ou changelog)* offre un aperçu des changements apportés par chaque version de Jeedom.
 
-En version **Beta** et **Alpha**, les changements sont beaucoup plus fréquents (plusieurs fois par jour) et ne provoquent pas de changement de version. Elles n'apparaitront donc pas dans le *Centre de Mise à jour*, c'est au testeur de mettre régulièrement le Core à jour, de préférence avant toute phase de test et avant de remonter un problème afin de s'assurer que celui-ci n'a pas déjà été corrigé plus tôt.
+Seules les versions [`master` *(stable)*](../core/#VERSION#/changelog){:target="_blank"} et [`release`](https://github.com/jeedom/core/blob/release/docs/#LANG#/changelog.md){:target="_blank"} garantissent la présence d'un changelog détaillé et à jour.
 
-> L'équipe change parfois de version en cours de développement, pour marquer certaines phases. Mais contrairement à la version Stable, beaucoup de changements sont faits entre deux versions. Chaque testeur peut suivre les commits sur les branches [Github](https://github.com/jeedom/core).
+En `develop`, les intégrations étant continues, le journal des modifications n'est pas encore généré à cette étape. Pour prendre connaissance des changements apportés depuis la dernière version stable, il faut se référer aux [notes de version](https://github.com/jeedom/core/blob/develop/docs/release-notes.md){:target="_blank"} qui listent les *Pull Requests* validées sur cette branche.
 
-### Changelog
+Les branches annexes faisant quant à elles référence à un élément précis, elles ne nécessitent à première vue pas de détails pour être appréhendées.
 
-Dès le début du développement de la version **Alpha**, l'équipe essaye de tenir à jour le futur [Changelog](/fr_FR/core/4.5/changelog). Les nouveautés pouvant évoluer fortement voir être supprimées ou reportées, celui-ci n'est donc pas forcément à jour et n'a pas valeur de référence.
+## Plugins
 
-En version **Stable**, le changelog reprend chaque version mineure (4.1.26 -> 4.1.27 etc). En version **Beta** et **Alpha** le changelog est numéroté x.0.0 et ne correspond donc pas forcément à la version mineure en cours. Par exemple, lors du développement de la v4.2, le changelog est uniquement noté 4.2.0 alors qu'une beta peut être en 4.2.7. Lors du passage en **Stable**, le changelog tiendra alors compte de chaque future version mineure.
+La présente page s'attarde principalement sur les bêta-tests autour du core Jeedom mais le principe reste sensiblement le même pour les plugins. En effet, les plugins sont mis à disposition en version stable *(branche `master`)* par défaut mais ils disposent également de versions `beta` pour les développements en cours.
 
-### Ressouces
+Pour accéder aux plugins en version `beta`, il est nécessaire de cocher la case **Activer l'accès aux plugins bêta** dans [votre profil Market](https://market.jeedom.com/index.php?v=d&p=profils){:target="_blank"}. Il suffit ensuite d'installer ou de réinstaller le plugin dans cette version.
 
- [Accès Community](https://blog.jeedom.com/jeedom-partenaire-beta-testeur/)
- 
-Community [beta-testeurs](https://community.jeedom.com/c/salon-des-beta-testeurs/6)
+>**IMPORTANT**
+>
+>L'installation d'un plugin en version `beta` fait perdre tout accès au support officiel.
 
-[Doc contribuer](/fr_FR/contribute/)
+## Faire une remontée
 
-[Doc Développeurs](/fr_FR/dev/)
+Les bêta‑testeurs sont en première ligne pour identifier un dysfonctionnement, tester une nouvelle fonctionnalité ou valider une correction avant publication en stable.
 
-[Github](https://github.com/jeedom/core)
+Après avoir clairement analysé la situation, plusieurs canaux sont disponibles pour effectuer des remontées les plus détaillées possibles avec tout le contexte nécessaire. Quel que soit le canal choisi, la première étape indispensable consiste à effectuer une recherche afin de s'assurer que le sujet n'est pas déjà abordé pour ne pas créer de doublons.
+
+>**IMPORTANT**
+>
+>Il est crucial de comprendre un minimum le sujet par soi-même sans se reposer intégralement sur l'analyse d'une intelligence artificielle. Celle-ci peut toutefois rester utile pour la mise en forme de la remontée ou pour ajouter du complément *(vérifié)*.
+
+### Forum Jeedom
+
+Les remontées peuvent être formulées directement dans [le salon des bêta‑testeurs du forum Jeedom](https://community.jeedom.com/c/salon-des-beta-testeurs/6){:target="_blank"}.
+
+Choisissez la section adaptée à la catégorie de la remontée puis ajoutez les étiquettes *(tags)* en lien avec le sujet *(`v4_5` par exemple)*. Il ne reste plus qu'à rédiger votre retour en incluant le maximum d'informations afin que toute personne extérieure soit en mesure de comprendre, de reproduire et d'analyser la situation.
+
+>**INFORMATION**
+>
+>Le salon des bêta‑testeurs intègre également [une section **Suggestions**](https://community.jeedom.com/c/salon-des-beta-testeurs/suggestion/29){:target="_blank"} pour proposer des améliorations.
+
+### Issue GitHub
+
+Si, après recherche, une *issue* ou une *pull request* est déjà ouverte sur le même sujet alors vous pouvez y ajouter votre analyse à condition qu'elle apporte des éléments pertinents dans le cadre du développement concerné.
+
+Sinon, vous pouvez ouvrir [une *issue* sur GitHub](https://github.com/jeedom/core/issues){:target="_blank"} détaillant de manière exhaustive le dysfonctionnement rencontré.
+
+>**INFORMATION**
+>
+>L'anglais est la norme sur GitHub pour que tout un chacun soit en mesure de comprendre le sujet mais nous acceptons les textes rédigés en français.
+
+## Contribuer au développement
+
+Que ce soit pour corriger une simple faute d'orthographe ou de syntaxe, ou même pour proposer un changement plus important, tout le monde peut participer au développement et à l'évolution de la solution Jeedom à son niveau.
+
+### Documentation
+
+Les pages de documentation que vous consultez actuellement nécessitent des mises à jour et des adaptations régulières pour rester valables et fiables. L'assistance de la communauté est grandement appréciée à ce niveau.
+
+Quelques spécificités sont à prendre en compte avant de proposer des changements sur la documentation. Il est donc indispensable de prendre connaissance des bonnes pratiques pour [contribuer à la documentation](../contribute/doc) en premier lieu.
+
+### Core et Plugins
+
+A l'instar de la documentation, le core Jeedom ainsi que la plupart des plugins sont également ouverts aux contributions externes. Référez-vous à la page ["Contribuer au core ou aux plugins"](../contribute/core) pour en savoir plus.