Recherche personne pour faire de la doc sur les modules

[Anonyme]

Contenu supprimé à la demande de son auteur

[TaG]

Hello,

En attendant de pouvoir créér dans le how-to, car sans images, ça va être coton.

Désolé pour les possibles fautes

Mais vu que j'avais un pull à faire grace à Tomdom !

Voici une procédure pour déposer une requête de modification d'un document sur github

Je pars du principe que vous avez déjà un fork du projet ou vous souhaitez pousser une modification.

Dans mon cas, je souhaite donc pousser une modification sur le fichier history.class.php
Ce fichier se situe dans le core de jeedom et plus précisément ici : core/class/

1 On est donc sur mon dépôt (TaGGoU91 / core) qui est indiqué comme étant un fork de Jeedom/core
2 On se rend donc dans /core/class (le premier core est en gras, c'est le dépôt ou je suis (core, cf Petit 1)
3 On a donc notre fichier history.class.php - On clique sur le fichier



1 On est donc bien dans notre fichier
2 On clique sur le crayon pour entrer en modification



Afin de faire une recherche dans le fichier (dans mon cas, je ne suis pas Dev, ni créateur du fichier que l'on va modifier, je ne sais donc pas ou ce situe le bout de code que je veux modifier).
Il faut en premier, faire un clic avec la souris DANS le bloc ou il y a le code
Ctrl + F
Coller le texte que vous cherchez (un élément significatif et une ligne seulement, pas tout un bloc d'un coup)
Entrée

Si vous ne cliquez pas dans la fenêtre contenant le texte ou le code que vous cherchez, c'est la recherche du navigateur qui va s'ouvrir, et dans mon cas, sur Google chrome, ça ne sait pas faire la recherche dans le code ou la documentation directement.

1 Le champ de recherche, oui c'est assez mince comme information, la ligne copié est bien plus grande .



1 En jaune, c'est le résultat de la recherche
2 En bleu, ce que je viens de sélectionner et que je souhaite modifier/remplacer par le bloc code fournit par Tomdom (encore merci à toi !!! )



Je supprime donc le bloc puis je le remplace.

Ensuite, sur la partie basse on trouve ceci :
1 On indique un titre explicite si possible
2 On entre une description un peu plus précise (dans mon cas, ça serait trop long, le lien vers le forum sera plus parlant)
3 On s'assure que ça soit bien coché comme ceci
4 On commit !



Non, ça n'est pas terminé, on ne va pas manger un gâteaux pour se féliciter

1 On clique sur l'onglet Pull Request
2 New Pull Request (PR pour les intimes)


1 On est ce coup-ci logique, on compare la base de jeedom avec notre repository à nous
2 Celà indique les modifications (le premier c'est parce que je me suis remis à jour depuis jeedom, le second concernant justement le changement de la fonction lastchangestateduration, parfait !!!)
3 L'ancien code
4 Le nouveau code
5 On créé le Pull Request (PR)




1 On clique sur les trois petits points
2 On recopie les informations que l'on a saisi précédemment
3 Idem, on recopie (d’où l'utilisation des ... à l'étape 1 pour s'éviter une réécriture)
4 On clique sur Create Pull Request



C'est terminé.
Il n'y a que les utilisateurs ayant un droit de push sur jeedom qui peuvent valider le PR.
Pour vous assurez que votre modification est bien dans la liste, vous pouvez cliquer sur Pull Requests



On obtient la liste des PR en attente de validation
1 On voit bien le notre





Je ne sais pas si c'est normal de voir le pr concernant la mise à jour depuis le core vers mon repository

[tonnerre33]

Ton tuto est parfait, merci beaucoup

[TaG]

Ton tuto est parfait, merci beaucoup

Merci pour ton retour !!!

[tonnerre33]

Ton tuto est parfait, merci beaucoup

Merci pour ton retour !!!

De rien par contre j'ai une question, j'ai lu dans les discussions précédentes et dans ton tuto qu'il y a une histoire de branche "beta" mais je ne la trouve pas dans le jeedom/core ni dans le jeedom/doc

SI tu pouvais m'en dire un peu plus sur ce beta ^^ ca serait sympas (dans ton tuto, je l'ai vu dans "comparing changes" TaGGoU91/core compare beta)

merci d'avance

Edit : c'est sur ce post que j'ai lu qu'il fallait pousser en beta avec une confirmation loic
viewtopic.php?f=57&t=9057&start=80#p495940

[TaG]

Me faut un pc pour tester ça.

[Sabato]

Bonjour,

je me posais la question quand on propose une modification sur une doc, est-ce qu'il faut le faire sur le fichier qui regroupe tout les chapitres ou sur le fichier du chapitre ou sur les 2 ?

Par exemple j'ai proposer une correction dans le Yeelight.asciidoc du plugin xiaomi de lunarok. La correction a été accepté mais je ne la retrouve pas dans le fichier configuration.asciidoc.

Il etait ecrit "prametres" au lieu de "parametres"