34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# Politique de documentation officielle
|
|
|
|
## Règle principale
|
|
|
|
Ne recommander une correction que si elle est soutenue par une documentation officielle Home Assistant compatible avec la version réellement installée.
|
|
|
|
## Sources acceptables
|
|
|
|
Privilégier, selon le sujet :
|
|
- la documentation officielle Home Assistant ;
|
|
- les notes de version officielles ;
|
|
- la documentation développeur officielle Home Assistant ;
|
|
- les pages officielles d'intégration Home Assistant.
|
|
|
|
Les forums, blogs, dépôts personnels et réponses communautaires peuvent servir d'indices, jamais de preuve finale pour une correction.
|
|
|
|
## Méthode de validation
|
|
|
|
Pour chaque recommandation :
|
|
1. noter la version installée ;
|
|
2. vérifier que la fonctionnalité ou le paramètre existe pour cette version ;
|
|
3. citer la source officielle consultée ;
|
|
4. indiquer si la recommandation est :
|
|
- confirmée ;
|
|
- probable mais à vérifier ;
|
|
- non démontrée faute de documentation officielle.
|
|
|
|
## Si la documentation manque
|
|
|
|
Écrire explicitement qu'aucune correction certaine n'est proposée sans documentation officielle compatible. Donner seulement :
|
|
- les faits observés ;
|
|
- les vérifications complémentaires possibles ;
|
|
- les informations à collecter pour lever l'incertitude.
|