✨ 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:

1 « 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 »