Jeedom revisite sa documentation!

Salut,

Je cherche une solution de doc colalborative pour un projet communautaire. C’est quoi les solutions techniques retenues ici ? A moins que ce soit du dev maison ?

A la base c’est un repo GitHub avec github page activé.
Donc çà répondrai à ta demande, plusieurs personnes avec les droits pouvant updater les docs.

De notre coté pour gérer les docs, celles du core, des plugins, leurs traductions etc c’est énorme de développement interne pour qu’un max de chose de fasse en auto à partir d’autres repos.

La partie traduction et génération des fichiers i18n a été complètement désactivée pour les plugins tiers pour l’instant.
Et cela pour la partie docs et pour la partie plug-in donc.

Je comprends. J’ai étudié la notion de page dans Github, mais ce n’est pas adapté à ma communauté qui n’est pas technophile.

Merci pour les réponses.

Pour ma part, j’ai fait une demande que zoic21 puisse avoir accès à mes repo privés sur Github il y a quelques jours mais toujours aucun retour de sa part.

Je suis surpris que si peu de plugin de contributeurs soient visibles sur le site officiel.

Bonjour,

Comme l’ont signalée d’autres utilisateurs, il y a une coquille dans la documentation.
Pour docker, Le tag latest a disparu et donc, ce qu’il y a dans la doc, ne fonctionne plus (pull jeedom/jeedom)

En attendant de retrouver ce tag latest (finalisation d’une release a partir de la branche beta?):

  • Quelle version 'stable" doit-on pour faire l’installation?
  • Quelle version doit-on prendre pour une mise a jour d’un container jeedom:latest?

Je ne trouve pas de changelog dans les branch, cela serait cool pour suivre les maj des commit des branch.

Bonjour,
à propos de doc, je ne connaissais pas cet écran d’accueil (p-e nouveau sur la v4 d’ailleurs)


Les 3 icones envoient sur l’ancienne doc et c’est moche, le design n’a pas suivi ni les images.
https://jeedom.com/start
https://jeedom.github.io/documentation/premiers-pas/fr_FR/index
https://jeedom.github.io/documentation

(edit) j’ai trouvé aussi ce lien dans la page login de jeedom, ‹ premiers pas ›:
https://jeedom.github.io/documentation/premiers-pas/fr_FR/index#tocAnchor-1-3-1
(et désolé)

L’accès au fonctions API du core v3 de l’ancienne doc n’est plus accessible.

j’ai juste trouvé ça doc api
Comptez vous rétablir une documentation plus accessible aux débutants… avec les rubriques regroupées par fonction et exemples comme dans l’ancienne Doc

Bonjour,
Ce n’est pas clair ce que tu cherches, toutes la doc est sur le site, regarde sectiond dev:
https://doc.jeedom.com/fr_FR/dev/tutorial_plugin
et juste en dessous il y a l’api http, jsonrpc, le phpdoc et tout ce qu’il faut savoir sur la structure d’un plugin…

Dans l’ancienne doc il y avait regroupé par thème les fonctions math, time, date …
a utiliser dans les scénarios avec qq exemples

@mick37

Les fonctions des scénarios sont encore dans la doc des scénarios:
En v3: https://doc.jeedom.com/fr_FR/core/3.3/scenario
En v4: https://doc.jeedom.com/fr_FR/core/4.0/scenario

Bonjour
Nous n’avons pas touché a l’organisation de la documentation en 3.3 donc je comprends pas ce que tu dis on a rien changé

merci pour les liens dans la nouvelle doc, avant c’était dans la doc du core, donc je ne cherchais pas au bonne endroit.
mea-culpa :thinking:

Bonjour

C’est moi qui ne comprends pas votre réponse. Je ne faisais que donner les liens vers la doc des scénarios en v3 et v4. Erreur de bouton Répondre ?

Je ne comprends d’ailleurs pas le manque de réponse de votre part ni de l’équipe Jeedom sur d’autres sujets comme par exemple celui du ménage fait dans la fonction postInstallUpdate.
Ici pour ceux qui y ont l’accès: Fonction du core qui fait le ménage dans les plugins: preInstallUpdate / postInstallUpdate - #51 par jpty

1 « J'aime »

Bonjour,
Effectivement erreur de bouton répondre désolé

Pour le manque de réponse le community comme son nom l’indique est communautaire, si vous voulez des réponses officielles il faut passer par les voix officielles tout simplement.

Je ne veux pas forcément une réponse officielle. Il n’y a que vous qui pouvez répondre.
Je voudrais la façon de faire pour préserver un plugin fonctionnel qui lors d’une mise à jour se verra amputé de données qu’il aurait créés et qui vont se faire supprimer par postInstallUpdate
AMHA, le nettoyage par postInstallUpdate en 4.0.56 a été mis en service bien trop rapidement.

1 « J'aime »

J’ai relu le post tout est dedans il n’y que l’on puisse rajouter.

Vous ne pouvez/voulez même pas ajouter :

$plugin->callInstallFunction('pre_before_cleaning'); // Fonction *plugin*_before_cleaning à définir dans pre_install.php

ou

$plugin->callInstallFunction('before_cleaning'); // Fonction *plugin*_before_cleaning à définir dans install.php

au début de la fonction postInstallUpdate avant le nettoyage ? :thinking:

Pourquoi ? Ça existe déjà on ne va doubler les fonctions

Le pb est que le plugin doit installer une fonction et qu’elle soit exécutée avant le nettoyage le tout en une seule MAJ.
Dans preInstallUpdate, la fonction de renommage est dans le zip qui n’a pas encore été téléchargé.

1 « J'aime »