✨ La documentation Gladys évolue : découvrez les nouveautés!

Salut à tous !

Ce matin, j’ai travaillé sur plusieurs améliorations de la documentation Gladys pour la rendre plus claire et accessible.

:pushpin: Simplification de la navigation

Il existe maintenant une liste claire des différentes façons d’installer Gladys :

Dans la page « Commencer », je détaille chaque méthode d’installation et le matériel recommandé :

:desktop_computer: Nouveau tutoriel : Installer Gladys Assistant sur un mini-PC

Puisque les mini-PC sont désormais la solution recommandée pour installer Gladys, j’ai mis en avant un nouveau tutoriel dédié :

La vidéo provient de la formation Gladys. J’ai décidé de l’extraire pour montrer la qualité du contenu proposé. :movie_camera:

:pushpin: À découvrir ici :
:point_right: Installer Gladys sur un mini-PC

:whale: Amélioration de la documentation d’installation Docker/Docker Compose

Les tutoriels Docker/Docker Compose ont été mis à jour pour mieux refléter la réalité d’une installation en 2025.

:earth_africa: Une documentation plus internationale

La page d’accueil et toute la documentation d’installation en anglais sont désormais pensées pour un public international, avec un focus particulier sur les États-Unis.

J’ai également migré tous les liens vers Amazon US, et supprimé les références spécifiques à la France (ex : Freebox Delta).

:speech_balloon: Vos retours ?

Si vous trouvez que certaines parties de la documentation manquent de clarté, faites-moi signe !

Je suis preneur de retours concrets, notamment de la part des débutants qui rencontrent des difficultés à démarrer avec Gladys. Vos avis sont précieux pour continuer à améliorer l’expérience utilisateur. :smiley:

À bientôt !

6 « J'aime »

C’est plus clair. Super d’avoir ajouté un disclaimer pour le Raspberry Pi. C’est vrai qu’en rapport qualité/prix, on y est plus.

1 « J'aime »

En effet c’est bien plus claire.
Juste un petit détail.
Dans le menu
Gladys plus s’affiche en bas de la page de mon navigateur.

Lorsque j’ai cliqué dessus, je n’ai pas remarqué tout de suite que la flèche à côté c’était positionné vers le bas.


J’ai cru que le lien était mort.
après plusieurs cliques j’ai vu qu’il fallait que je défile le menu vers le bas pour avoir accès aux sous menus.

Pour éviter cela pour les gents comme moi qui sont longs à la détente, je te propose d’ajouter à la fin du menu et sans sous menu « Le Forum » Et dans la page tu mets Vous avez des questions n’hésitez pas à poser vos questions sur le forum, la communauté Gladys est très réactive, etc.

@bjm La barre de défilement apparaît automatiquement au moment du clic, donc l’utilisateur voit qu’il y a un élément en dessous.

Ajouter un élément en dessous ne changera rien, le même effet se produira.

Honnêtement, je ne pense pas qu’il y ait un vrai problème. Le site utilise Docusaurus, une plateforme open-source largement adoptée par des milliers de sites. Ce n’est pas un outil développé en interne, donc je n’ai pas la main sur ce fonctionnement. :slightly_smiling_face:

salut @pierre-gilles , je suis en train de me replonger dans la doc et j’ai une question existentielle : qui est ton public ?
Je m’explique. Tu démarres avec du vouvoiement, puis tutoiement, puis vouvoiement, etc.
Le but serait d’harmoniser soit en vous soit en tu.
Alors je suis de la vieille école et sur un site je préfère clairement le vouvoiement (même si dans la vie je tutoie assez rapidement).
Voilà, c’était la question du soir :blush:

Petit point lors du choix de la box domotique, je mettrais l’offre beelink Gladys en premier (plutôt qu’à la fin) avant amazon en indiquant que l’achat via Gladys permet de faire vivre et avancer le projet (même si il existe une affiliation avec amazon).
ÉDIT : je viens de passer sur la page Installation sur mini-pc et tu mets bien en avant l’offre Gladys :ok_hand:

2 « J'aime »

Des utilisateurs comme toi ! :slight_smile:

Bonne remarque ! Comme il y a eu plusieurs auteurs (et un peu d’IA ici et là), l’harmonisation n’est pas toujours parfaite. Je vais y jeter un œil.

Le vouvoiement donne un côté plus « pro », mais il crée aussi une distance et peut donner l’impression que Gladys est géré par une grosse équipe, alors que c’est un modeste projet open-source à taille humaine.

Le tutoiement, lui, est plus convivial, mais peut paraître moins formel.

Personnellement, j’ai une préférence pour le tutoiement, donc je vais relire et voir ce qui me semble le plus naturel ! :slight_smile:

C’est toujours un équilibre à trouver : dans l’open-source, beaucoup d’utilisateurs n’aiment pas quand ça semble trop « commercial ».

Mon idée ici était d’abord d’expliquer quelles sont les meilleures plateformes pour faire tourner Gladys, avant de mentionner mon offre, sans donner l’impression de forcer la main. Mais c’est un bon point, je vais voir si je peux mieux le présenter !

1 « J'aime »

Ajout d’une nouvelle vidéo au tutoriel : Installer Gladys Assistant sur un Mini-PC !

Installer Gladys Assistant sur Mini-PC Ubuntu Server :rocket:

Cette vidéo est aussi extraite de la formation, et j’ai décidé de la mettre en public dans la documentation pour aider encore plus de mondes sur l’installation de Gladys sur mini-PC, et donner un avant-goût de la formation !

1 « J'aime »

Salut @pierre-gilles
J’ai Node-Red d’installé sur un Docker externe à Gladys.
Il a fallut que je retourne voir ta vidéo.
Dans la doc tu ne parle que de Node-Red intégré à Gladys.
Il me semble que tu pourrais ajouter en fin de page " En complément pour ceux qui ont ou veulent installé Node-Red hors Gladys le lien vers la vidéo du blog"
Intégrer Node-RED avec Gladys Assistant en MQTT | Gladys Assistant

Une autre remarque, si tu pouvais ajouter une fonction « recherche » au site, cela serait pas mal.

J’imagine que tu parles de cette documentation ?

Effectivement elle a été écrite par celui qui a développé l’intégration Node-RED interne à Gladys, donc ça ne parle que de l’intégration.

Je viens de faire une PR pour rajouter ça :

Bonne idée, il faut que j’investigue ce qui est possible avec Docusaurus :slight_smile:

Salut @pierre-gilles,

le lien vers la documentation google cast est mort quand tu essayes d’y accéder depuis Gladys dans la page d’intégration.

Salut @Nagromdark !

Bien vu, c’est de ma faute j’avais totalement oublié d’écrire la documentation :smiley:

C’est corrigé, le lien est désormais bon :white_check_mark:

Nouveau tutoriel :

J’ai fais une demande à Algolia cet après-midi pour avoir une clé d’API, et hop c’est bon la recherche est live sur le site :white_check_mark:

Disponible sur tout le site (Documentation, blog, etc…).

Le site est crawlé tous les 7 jours !

6 « J'aime »

Trop génial !

1 « J'aime »

Bonsoir @bjm
Dans le tuto node red et Rflink , j’avais détaillé l’installation de node red, mais je suis d’accord un tuto rien que pour l’installation de Node red sera plus clair.
On peut en refaire un, en prenant les morceaux de mon tuto pour gagner du temps :wink:

La vidéo de @pierre-gilles sur l’installation de Node-Red est très bien faite.
mis à part ajouter la commande
sudo chown -R 1000:1000 /var/lib/node-red
que tu as donné dans ton post Rflink, Node Red et Gladys - #77 par Psoy pour ceux qui sont sur mini PC.
et l’ajout de
-v /home/pi/.ssh/id_rsa:/home/node-red/.ssh/id_rsa:ro \
Pour ceux qui comme moi veulent utiliser leur clé SSH pour contrôler un autre appareil en SSH depuis Gladys avec node-red-contrib-ssh-v3.
Mon avis est qu’il n’est pas nécessaire de réinventer la roue, sauf si tu veux aller plus loin après dans l’explication de l’utilisation de Node-Red.

Bonsoir @bjm
Je pensai que tu voulais refaire un tuto special Node_red, autant pour moi. :wink:

Suite à ton retour, j’ai harmonisé la documentation :slightly_smiling_face:

Après quelques tests, je suis d’accord : dans ce contexte, le vouvoiement apporte un ton plus sérieux et crédible.

J’ai mis à jour les articles suivants :

N’hésitez pas à signaler d’autres incohérences, mon objectif est d’avoir une documentation aussi claire et agréable que possible !

La PR Github :

4 « J'aime »