From d90271d8f49edd19ba96d3bf4c44b4fdccba3854 Mon Sep 17 00:00:00 2001 From: Juicy Date: Tue, 10 Dec 2024 00:39:03 +0000 Subject: [PATCH] docs(readme): add a troubleshooting section for timeout issue --- README-fr.md | 28 +++++++++++++++++++++++++++- README.md | 28 ++++++++++++++++++++++++++++ images/timeout-error.png | Bin 0 -> 5523 bytes 3 files changed, 55 insertions(+), 1 deletion(-) create mode 100644 images/timeout-error.png diff --git a/README-fr.md b/README-fr.md index 42f560c..3898895 100644 --- a/README-fr.md +++ b/README-fr.md @@ -154,12 +154,38 @@ Une fois l'installation terminée, voici comment configurer et accéder à Linus 4. Pendant la configuration, sélectionnez une entité météo ou d’alarme si nécessaire (ces étapes sont facultatives). 5. Une fois la configuration terminée, un nouvel **icône avec un nœud papillon** apparaîtra dans le menu de gauche. Cliquez dessus pour accéder directement à Linus Dashboard. - #### ✨ Astuce - Si l’icône n’apparaît pas immédiatement, essayez de redémarrer Home Assistant une nouvelle fois. --- +### ❗ Dépannage + +#### Résolution des erreurs de timeout ou des messages d’erreur en rouge + +Si vous rencontrez un message d’erreur comme celui-ci en essayant d’utiliser Linus Dashboard : + +![Erreur de Timeout](https://github.com/Thank-you-Linus/Linus-Dashboard/blob/main/images/timeout-error.png) + +**Suivez ces étapes pour résoudre le problème** : + +1. **Videz votre cache** : + - Pour les navigateurs : Videz le cache de votre navigateur. + - Pour l’application mobile Home Assistant : Effacez le cache de l’application via les paramètres de votre appareil. + - Si vous utilisez un proxy inverse ou un service DNS comme Cloudflare : Videz également le cache là-bas. + +2. **Forcez un rafraîchissement** : + - Sur **Windows** : Appuyez sur `CTRL + F5`. + - Sur **Mac** : + - Maintenez `⇧ Shift` et cliquez sur le bouton Recharger. + - Ou maintenez les touches `⌘ Cmd` et `⇧ Shift`, puis appuyez sur `R`. + +3. **Vérifiez votre configuration** : Assurez-vous que votre instance Home Assistant est correctement configurée et qu’il n’y a pas de problèmes liés au réseau. + +Si ces étapes ne résolvent pas le problème, n’hésitez pas à ouvrir une issue sur le [dépôt GitHub](https://github.com/Thank-you-Linus/Linus-Dashboard/issues) en fournissant des détails sur votre configuration et le message d’erreur. + +--- + ## 📣 Rejoignez notre communauté - 🌟 **Montrez votre soutien** : [GitHub Stars](https://github.com/Thank-you-Linus/Linus-Dashboard/stargazers) diff --git a/README.md b/README.md index 6fa758e..f3c0508 100644 --- a/README.md +++ b/README.md @@ -157,6 +157,34 @@ After installation, follow these steps to configure and access Linus Dashboard: #### ✨ Tip - If the icon doesn’t appear immediately, try restarting Home Assistant again. + +--- + +### ❗ Troubleshooting + +#### Fixing Timeout or Red Error Messages + +If you encounter an error message like the one below when trying to use Linus Dashboard: + +![Timeout Error](https://github.com/Thank-you-Linus/Linus-Dashboard/blob/main/images/timeout-error.png) + +**Follow these steps to resolve the issue**: + +1. **Clear your cache**: + - For browsers: Clear your browser cache. + - For the Home Assistant mobile app: Clear the app cache via your device settings. + - If you're using a reverse proxy or a DNS service like Cloudflare: Clear the cache there as well. + +2. **Force a refresh**: + - On **Windows**: Press `CTRL + F5`. + - On **Mac**: + - Hold `⇧ Shift` and click the Reload button. + - Or, hold down `⌘ Cmd` and `⇧ Shift` key, then press `R`. + +3. **Check your setup**: Ensure your Home Assistant instance is correctly set up and that there are no network-related issues. + +If these steps don’t resolve the issue, feel free to open an issue on the [GitHub repository](https://github.com/Thank-you-Linus/Linus-Dashboard/issues) with details about your setup and the error message. + --- ## 📣 Join Our Community diff --git a/images/timeout-error.png b/images/timeout-error.png new file mode 100644 index 0000000000000000000000000000000000000000..a0e843c9635516a5424af7bc67af5870a23d4914 GIT binary patch literal 5523 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 Sx^k{yE5H