Traduction perso du post:How to help us help you - or How to ask a good question - Configuration - Home Assistant Community que l’on pourrait publier et épingler sous le titre: [Tuto] Aidez nous à vous aider - comment bien formuler votre demande d’aide
Préambule
Ce forum n’est pas un Service Après Vente
Les intervenants du forum ne travaillent pas pour Home Assistant, qui est un projet Open Source. Nous sommes tous là sur notre temps libre, dans le seul but de partager autour de sujet Home assistant. Tous les sujets n’obtiendront pas forcément de réponse, et encore moins une qui vous aidera à résoudre votre problème.
Ce n’est pas non plus un forum général sur la domotique, c’est un forum dédié à Home Assistant et aux sujets qui s’y rapportent. Toute question sur Home Assistant, et sur l’utilisation de choses avec Home Assistant, est la bienvenue ici. Cependant, nous ne pouvons pas vous aider à propos de tout ou n’importe quoi.
Avant de poster
Langue
Ce forum est un forum francophone. Pour des questions en anglais, il suffit d’aller sur le forum principal: https://community.home-assistant.io/ . Il peut être utile d’y faire un tour avec divers différents outils de traduction disponibles.
Il existe d’autres forums de discussions dans d’autres langues si nécessaire.
Recherche
Il est probable que votre question ait déjà été posée et résolue. Si vous recherchez sur le forum, vous pourriez trouver la réponse et vous épargner beaucoup de temps.
Vous n’y trouverez peut-être pas la réponse parfaite à votre question, mais cela devrait vous rapprocher suffisamment pour commencer.
Si vous trouvez une publication qui résout votre problème, veuillez cliquer sur le cœur de cette publication (liker). Cela aidera les autres à identifier cette publication comme utile, et informera l’auteur qu’il a aidé des gens.
Vous devriez également consulter le Portail HACF une liste d’articles rédigés par la communauté sur de nombreux sujets.
Comment chercher
Essayez de ne rechercher que le cœur de votre question, le message d’erreur (sans vos données spécifiques), le nom du composant ou de l’add-on, l’opération que vous souhaitez effectuer, etc.
Quelques exemples de recherches pour des scénarios courants :
- hassio “no such image”
- va et vient sans neutre
- Z2M configuration
J’ai trouvé un sujet similaire, mais il est déjà résolu et j’ai toujours un problème. Devrais-je poster dedans ?
En règle générale – non.
Ce que vous pourriez faire, c’est poster votre question dans un nouveau sujet et y mettre un lien vers le sujet que vous avez trouvé (voir également 9 Montrez ce que vous avez fait ci-dessous).
Avez-vous lu (et recherché dans) la documentation ?
La documentation est là (en anglais), et la liste des intégrations est ici.
Il y a quelques sections fortement recommandées que tout le monde devrait lire (utilisez les solutions de traduction évoquées ci dessus si nécessaire):
La documentation et les intégrations possèdent également des fonctions de recherche.
Attention, Home Assistant évolue rapidement. Si vous consultez une publication sur le forum, un article de blog, ou une vidéo YouTube qui date de plusieurs mois, cela pourrait contenir des informations obsolètes. Si vous rencontrez des problèmes, il est bon de vérifier par rapport à la documentation actuelle.
N’oubliez pas, les add-ons auront aussi leur propre documentation. Dans de nombreux cas, elle sera intégrée à l’add-on, ou accessible via celui-ci, mais sinon vérifiez la page de l’add-on ou le dépôt GitHub pertinent (pour un add-on non-core).
Pour les nouveaux arrivants, n’oubliez pas qu’il y a toute une section du portail dédiée aux premiers pas sur Home assistant !
Le problème n’a pas été résolu, il est temps de poster votre demande d’aide.
Poster une bonne question
Utilisez une catégorie pertinente
Les catégories sont assez explicites, utilisez les afin que vos messages arrivent au bon endroit. En l’occurrence « Entraide Home Assistant » pour une demande d’aide.
Utilisez des balises pertinentes
Les balises sont ajoutées à un sujet pour aider à améliorer le moteur de recherche du forum, ainsi que pour donner un contexte supplémentaire aux personnes lisant votre question.
Les balises courantes incluent tutoriel, mqtt, templates, switch, etc.
Soignez votre titre
Avoir un bon titre de sujet est essentiel. Il devrait résumer votre publication de sorte que, sans même l’ouvrir, les lecteurs puissent avoir une bonne idée de ce dont il s’agit. Un bon sujet inclut généralement :
- La partie unique de l’erreur que vous obtenez
- Le nom de l’intégration ou la description de l’action
- La description de ce avec quoi vous avez un problème
- Un ton neutre (sans émotion)
Par exemple :
- Bon Comment utiliser un minuteur dans une automatisation pour retarder une action ?
- Mauvais Le minuteur ne fonctionne pas
- Horrible Problème/Besoin d’aide
- Bon Z2M - Impossible d’inclure le dispositif ZXX123
- Mauvais ZXX123 non découvert
- Horrible Problème Z2M
Si vous avez du mal à rédiger un bon titre de sujet, laissez-le pour la fin, une fois que vous avez écrit toute la question, il pourrait être plus facile d’écrire un titre qui résume votre prose.
Poser correctement la question
Rappel, nous sommes sur un forum public, restons courtois! L’ambiance du forum est positive et bienveillante, protégeons là!
Décrivez le but, pas le problème
Il est facile de tomber dans le piège du problème XY, dit autrement vous avez peut être pris le problème à l’envers.
Si vous prenez quelques phrases pour décrire votre objectif en premier, les autres peuvent comprendre ce que vous essayez de réaliser, même si vous êtes parti sur une fausse piste.
Montrez ce que vous avez fait
Si vous arrivez avec une demande d’aide qui suggère que vous n’avez fait aucun effort, vous êtes moins susceptible d’obtenir une aide de qualité, et votre publication pourrait même être ignorée. Expliquez un peu ce que vous avez fait jusqu’à présent, comme :
- Lien vers d’autres fils de discussion que vous avez trouvés et essayés, et expliquez pourquoi ils ne vous ont pas aidé
- Décrivez ce que vous avez essayé et quels ont été les problèmes
Montrer que vous avez fait des efforts aidera à démontrer que vous ne cherchez pas simplement que les autres fassent tout le travail à votre place.
Dites-nous comment vous avez installé Home Assistant
Dites-nous si vous utilisez une image HAOS officielle, une installation Docker, une installation machine virtuelle, etc. Les informations souvent très utiles à connaître incluent :
- Quel numéro de version de Home Assistant utilisez-vous ?
- Comment vous l’avez installé. Si vous n’utilisez pas une installation basée sur HAOS, n’oubliez pas de nous indiquer le système d’exploitation
- Tout code pertinent - correctement formaté
tout est expliqué dans le template des messages d’aide…
Souvenez vous que des mots comme dernière, actuelle, plus récente, etc., ne sont pas des numéros de version.
Formatez-le correctement
Lorsque vous partagez du code, partagez-le sous forme de texte et non d’image. Rappelez-vous que l’espacement est critique en YAML, et si vous collez simplement le code sur la page, il aura l’air moche et personne ne saura si le problème est dû à l’espacement.
Il est indispensable d’utilisiez la touche balises </>.
Par exemple:
- ceci est facile à lire et il est évident si l’espacement est correct :
# Turn off lights when everybody leaves the house
- alias: 'Rule 2 - Away Mode'
trigger:
platform: state
entity_id: group.all_devices
to: 'not_home'
action:
service: light.turn_off
entity_id: group.all_lights
- ceci, ne l’est pas alors qu’il s’agit exactement du même code, mais sans les balises
``` :
Turn off lights when everybody leaves the house
- alias: ‘Rule 2 - Away Mode’
trigger:
platform: state
entity_id: group.all_devices
to: ‘not_home’
action:
service: light.turn_off
entity_id: group.all_lights
En bref, vous utilisez le bouton </> dans la barre d’outils de l’éditeur (il peut être caché, si c’est le cas, cliquez sur le + à droite) ou encadrez votre bloc avec trois accents graves (```).
Décrivez ce que vous avez changé
Si cela fonctionnait auparavant, dites-nous ce qui a changé depuis. Si vous avez modifié une automatisation, mis à jour quelque chose (une intégration personnalisée, un add-on, Home Assistant lui-même, etc.), dites le. Ne mentionnez pas seulement le dernier changement, dites tous les changements.
N’oubliez pas non plus – ne changez qu’une seule chose à la fois, puis testez. Si vous changez plusieurs choses et que cela fonctionne maintenant, vous ne savez pas ce qui a résolu le problème. Pire encore, l’une de ces choses l’a peut-être résolu, mais l’une d’entre elles a peut-être introduit un nouveau problème.
Partagez les journaux (logs)
Si quelque chose ne fonctionne pas, vérifiez les journaux et voyez si des éléments y sont enregistrés. Le journal de Home Assistant est disponible dans l’interface utilisateur, bien que les informations sur les composants personnalisés n’apparaissent que dans le fichier journal sur disque, ou vous pouvez les vérifier en utilisant la ligne de commande – ha core logs. Gardez à l’esprit que l’interface utilisateur ne montrera que les erreurs, et d’autres entrées peuvent être utiles et pertinentes. D’autres sources comprendront :
- Fichier journal de Home Assistant
homeassistant.log
- Journal du Superviseur
- Journaux des add-ons
Pour les automatisations et les scripts, assurez-vous d’inclure la trace de débogage. Télécharger et partager le fichier .json de la trace est un moyen efficace de fournir des informations sur la conception de votre automatisation et ce qui échoue.
Plus vous en dites, plus il est probable que le problème puisse être identifié.
Captures d’écran
Parfois, une image vaut mille mots, et inclure une capture d’écran peut aider. Ne le faites pas pour tout ce que vous pouvez copier et coller de votre configuration, YAML, code ou journaux (voir au dessus). Veuillez inclure uniquement des captures d’écran qui sont réellement utiles.
Relisez avant de poster
Oui, relisez votre propre publication avant de la poster. Assurez-vous que vous n’avez pas perdu le fil en cours de route, que cela a toujours du sens et que le sujet, les balises et la catégorie ont toujours du sens.
Les autres choses à assurer sont que vous utilisez des paragraphes, la ponctuation et les espaces blancs. Un mur de texte est difficile à lire.
Dois-je taguer des personnes ?
Généralement, non.
Cela donne l’impression d’être impoli, vous exigez que quelqu’un vous réponde. C’est différent si vous remerciez quelqu’un, évidemment.
Si vous taguez quelqu’un, restez poli et respectueux. Rappelez-vous que tout le monde est bénévole, et que personne n’est obligé de vous aider.
De même, veuillez ne pas envoyer de MP (message privé) aux gens pour demander de l’aide. Cela donne aussi l’impression d’être exigeant, et cela signifie que les autres ne peuvent pas apprendre de ce que vous faites.
J’ai posté…
Attendez…
Oui, la communauté est très active, mais ceux qui peuvent vous aider ne sont peut-être pas disponibles. Il peut facilement falloir plusieurs heures, voire un jour ou deux pour obtenir une réponse.
Mais ça fait des jours…
Si personne n’a répondu après quelques jours, relisez et voyez si le titre, la catégorie, les balises, ou même la publication elle-même nécessitent une attention particulière. Relisez ce guide et voyez si vous avez manqué quelque chose d’important.
Si vous pensez que tout est aussi bon que possible, alors vous pouvez envisager de le faire remonter en postant une réponse pour le rendre plus visible. Faire cela trop souvent, ou trop rapidement, peut vous faire paraître exigeant, et cela éloignera les gens.
J’ai résolu le problème !
Génial. Veuillez répondre à votre publication avec les détails de la façon dont vous l’avez résolu, et utilisez l’option pour le marquer comme la réponse (voir 21 ci-dessous).
Veuillez ne pas supprimer votre question, cela donnera l’impression que vous ne vous souciez que de vous-même, pensez que d’autres peuvent être confrontés au même souci que vous.
Des membres répondent, mais je n’ai pas la réponse
C’est fréquent. Il y aura toujours des choses que les membres ne savent pas (parce que vous ne leur avez pas dit, et peut-être même que vous ne saviez pas qu’il fallait le dire, ou parce que cela dépasse les limites de leurs connaissances).
Si quelque chose que les membres ont dit vous a fait avancer, faites-le leur savoir. Cela encouragera à continuer de vous aider. Si ce n’est pas le cas, faites savoir aux gens que vous avez essayé leur suggestion, et ce qui s’est passé. Encore une fois, cela encourage à continuer de vous aider.
La réponse de quelqu’un a résolu le problème !
Fantastique ! Maintenant, avant de partir… veuillez prendre le temps de marquer cela comme la réponse, vous le faites en sélectionnant la case à cocher sous le message:
N’oubliez pas non plus, pendant que vous y êtes, de cliquer sur le cœur pour liker la publication, en guise de remerciement.
Soyez respectueux
Les modérateurs veuillent, mais autant leur faciliter le travail…
N’utilisez pas ChatGPT
N’utilisez pas ChatGPT, ou des outils similaires, pour générer des réponses à des demandes d’aide sans les avoir testées. Ces outils produisent souvent des résultats qui semblent bons mais qui sont incomplets, trompeurs ou tout simplement faux.
Cela ne peut pas fonctionner, n’est-ce pas ?
Essayez 
Rappelez-vous, il n’y a jamais de garantie que vous obtiendrez une réponse – personne n’est tenu d’en fournir une. Ce que vous pouvez faire, cependant, c’est fournir une publication avec des informations de soutien pertinentes, qui montre que vous faites des efforts. Cela encouragera les gens à vous aider.
