✨ Die Gladys-Dokumentation entwickelt sich weiter: Entdecken Sie die Neuheiten!

Hallo zusammen!

Heute Morgen habe ich an mehreren Verbesserungen der Gladys-Dokumentation gearbeitet, um sie klarer und zugänglicher zu gestalten.

:pushpin: Vereinfachung der Navigation

Es gibt jetzt eine klare Liste der verschiedenen Möglichkeiten, Gladys zu installieren:

Auf der Seite « Loslegen » detailliere ich jede Installationsmethode und die empfohlene Hardware:

:desktop_computer: Neuer Leitfaden: Gladys Assistant auf einem Mini-PC installieren

Da Mini-PCs nun die empfohlene Lösung für die Installation von Gladys sind, habe ich einen neuen, dedizierten Leitfaden hervorgehoben:

Das Video stammt aus dem Gladys-Kurs. Ich habe es extrahiert, um die Qualität des angebotenen Inhalts zu zeigen. :movie_camera:

:pushpin: Zu entdecken hier:
:backhand_index_pointing_right: Gladys auf einem Mini-PC installieren

:spouting_whale: Verbesserung der Docker/Docker Compose-Installationsdokumentation

Die Docker/Docker Compose-Leitfäden wurden aktualisiert, um eine Installation im Jahr 2025 besser widerzuspiegeln.

:globe_showing_europe_africa: Eine internationalere Dokumentation

Die Startseite und die gesamte Installationsdokumentation auf Englisch sind nun für ein internationales Publikum konzipiert, mit besonderem Fokus auf die USA.

Ich habe auch alle Links zu Amazon US migriert und spezifische Verweise auf Frankreich (z. B. Freebox Delta) entfernt.

:speech_balloon: Euer Feedback?

Wenn ihr denkt, dass bestimmte Teile der Dokumentation unklar sind, gebt mir Bescheid!

Ich bin offen für konkrete Rückmeldungen, insbesondere von Anfängern, die Schwierigkeiten haben, mit Gladys zu beginnen. Eure Meinungen sind wertvoll, um die Benutzererfahrung weiter zu verbessern. :smiley:

Bis bald!

Das ist klarer. Super, dass du einen Hinweis für den Raspberry Pi hinzugefügt hast. Stimmt, was das Preis-Leistungs-Verhältnis angeht, ist man da besser bedient.

Das ist tatsächlich viel klarer.
Nur eine kleine Sache.
Im Menü
Gladys Plus wird am unteren Rand meines Browsers angezeigt.

Als ich darauf geklickt habe, habe ich nicht sofort bemerkt, dass der Pfeil daneben nach unten zeigte.


Ich dachte, der Link wäre tot.
Nach mehreren Klicks habe ich gesehen, dass ich das Menü nach unten scrollen musste, um auf die Untermenüs zuzugreifen.

Um das zu vermeiden, schlage ich vor, am Ende des Menüs und ohne Untermenü „Das Forum“ hinzuzufügen. Und auf der Seite könntest du schreiben: „Sie haben Fragen? Zögern Sie nicht, Ihre Fragen im Forum zu stellen. Die Gladys-Community ist sehr reaktiv, etc.“

@bjm Die Scrollleiste erscheint automatisch beim Klick, sodass der Benutzer sieht, dass es ein Element darunter gibt.

Ein Element darunter hinzuzufügen wird nichts ändern, der gleiche Effekt wird eintreten.

Ehrlich gesagt, ich glaube nicht, dass es ein echtes Problem gibt. Die Website verwendet Docusaurus, eine Open-Source-Plattform, die von Tausenden von Websites weit verbreitet ist. Es ist kein internes Tool, also habe ich keine Kontrolle über dieses Verhalten. :slightly_smiling_face:

Hallo @pierre-gilles, ich vertiefe mich gerade wieder in die Dokumentation und habe eine existenzielle Frage: Wer ist deine Zielgruppe?
Ich erkläre es. Du beginnst mit „Sie“, dann „du“, dann wieder „Sie“ usw.
Das Ziel wäre, entweder „Sie“ oder „du“ zu harmonisieren.
Ich bin altmodisch und bevorzuge auf einer Website klar das „Sie“ (auch wenn ich im echten Leben relativ schnell zum „du“ übergehe).
Das war die Frage des Abends :blush:

Kleiner Punkt bei der Wahl der Smart-Home-Box, ich würde das Angebot von beelink Gladys an erste Stelle setzen (statt ans Ende) vor Amazon, mit dem Hinweis, dass der Kauf über Gladys das Projekt am Leben erhält und voranbringt (auch wenn es eine Affiliate-Partnerschaft mit Amazon gibt).
EDIT: Ich bin gerade auf die Seite Installation auf Mini-PC gegangen und du setzt das Angebot von Gladys gut in den Vordergrund :ok_hand:

Benutzer wie du! :slight_smile:

Guter Punkt! Da es mehrere Autoren (und ein bisschen KI hier und da) gab, ist die Harmonisierung nicht immer perfekt. Ich werde mal einen Blick darauf werfen.

Das „Sie“ verleiht einen professionelleren Ton, schafft aber auch Distanz und kann den Eindruck erwecken, dass Gladys von einem großen Team verwaltet wird, obwohl es sich um ein bescheidenes Open-Source-Projekt in menschlichem Maßstab handelt.

Das „du“ ist dagegen gesprächiger, kann aber weniger formell wirken.

Persönlich habe ich eine Vorliebe für das „du“, also werde ich nochmal durchlesen und sehen, was mir am natürlichsten erscheint! :slight_smile:

Es ist immer ein Balanceakt: In der Open-Source-Welt mögen viele Benutzer es nicht, wenn es zu „kommerziell“ wirkt.

Meine Idee hier war zunächst, die besten Plattformen zu erklären, um Gladys zu betreiben, bevor ich mein Angebot erwähne, ohne den Eindruck zu erwecken, dass ich Druck ausübe. Aber es ist ein guter Punkt, ich werde sehen, ob ich es besser präsentieren kann!

Hinzufügen eines neuen Videos zum Tutorial: Gladys Assistant auf einem Mini-PC installieren !

Gladys Assistant auf Mini-PC mit Ubuntu Server installieren :rocket:

Dieses Video ist auch aus dem Kurs und ich habe beschlossen, es öffentlich in der Dokumentation zu veröffentlichen, um noch mehr Menschen bei der Installation von Gladys auf Mini-PCs zu helfen und einen Vorgeschmack auf den Kurs zu geben!

Hallo @pierre-gilles
Ich habe Node-Red auf einem externen Docker installiert, der nicht zu Gladys gehört.
Ich musste nochmal dein Video anschauen.
In der Dokumentation sprichst du nur von Node-Red, das in Gladys integriert ist.
Ich denke, du könntest am Ende der Seite ergänzen: « Zusätzlich für diejenigen, die Node-Red außerhalb von Gladys installiert haben oder installieren möchten, der Link zum Video des Blogs »
Intégrer Node-RED avec Gladys Assistant en MQTT | Gladys Assistant

Ein weiterer Hinweis: Wenn du eine Suchfunktion zur Website hinzufügen könntest, wäre das nicht schlecht.

Ich nehme an, du meinst diese Dokumentation?

Tatsächlich wurde sie von demjenigen geschrieben, der die Node-RED-Integration in Gladys entwickelt hat, daher geht es nur um die Integration.

Ich habe gerade einen PR erstellt, um das hinzuzufügen:

https://github.com/GladysAssistant/v4-website/pull/288

Gute Idee, ich muss herausfinden, was mit Docusaurus möglich ist :slight_smile:

Hallo @pierre-gilles,

der Link zur Google Cast-Dokumentation ist tot, wenn du versuchst, darauf von Gladys aus in der Integrationsseite zuzugreifen.

Hallo @Nagromdark!

Gut aufgepasst, das war mein Fehler, ich hatte die Dokumentation völlig vergessen zu schreiben :smiley:

Es ist korrigiert, der Link ist jetzt richtig :white_check_mark:

Neuer Leitfaden:

https://gladysassistant.com/de/docs/integrationen/google-cast/

Ich habe heute Nachmittag bei Algolia eine Anfrage für einen API-Schlüssel gestellt, und schon ist die Suche live auf der Website :white_check_mark:

Verfügbar auf der gesamten Website (Dokumentation, Blog, usw.).

Die Website wird alle 7 Tage durchsucht!

Toll!

Guten Abend @bjm
Im Node-Red- und Rflink-Tutorial hatte ich die Installation von Node-Red detailliert beschrieben, aber ich stimme zu, dass ein separates Tutorial nur für die Installation von Node-Red klarer wäre.
Wir können ein neues erstellen und dabei die relevanten Teile meines Tutorials verwenden, um Zeit zu sparen :wink:

Das Video von @pierre-gilles zur Installation von Node-Red ist sehr gut gemacht.
Abgesehen vom Hinzufügen des Befehls
sudo chown -R 1000:1000 /var/lib/node-red
den du in deinem Post Rflink, Node Red et Gladys - #77 par Psoy für diejenigen, die auf Mini-PCs sind, angegeben hast.
Und dem Hinzufügen von
-v /home/pi/.ssh/id_rsa:/home/node-red/.ssh/id_rsa:ro \
Für diejenigen, die wie ich ihren SSH-Schlüssel verwenden möchten, um ein anderes Gerät über SSH von Gladys mit node-red-contrib-ssh-v3 zu steuern.
Meine Meinung ist, dass es nicht notwendig ist, das Rad neu zu erfinden, es sei denn, du möchtest später bei der Erklärung der Verwendung von Node-Red weitergehen.

Guten Abend @bjm
Ich dachte, du wolltest einen speziellen Node_red-Tutorial neu machen. Mein Fehler. :zwinkern:

Aufgrund deines Feedbacks habe ich die Dokumentation harmonisiert :slightly_smiling_face:

Nach einigen Tests bin ich einverstanden: In diesem Kontext verleiht „Sie“ einen seriöseren und glaubwürdigeren Ton.

Ich habe die folgenden Artikel aktualisiert:

Zögern Sie nicht, weitere Inkonsistenzen zu melden, mein Ziel ist es, eine so klare und angenehme Dokumentation wie möglich zu haben!

Der GitHub-Pull-Request:

https://github.com/GladysAssistant/v4-website/pull/292

Hallo zusammen,

Ich habe neue Tutorials in der Dokumentation hinzugefügt, insbesondere zu Dashboards, und mehrere bestehende Artikel aktualisiert, um sie klarer und aktueller zu machen :grinning_face_with_smiling_eyes:

:tada: Neue Artikel:

:sponge: Aktualisierte Artikel:

Alle diese Änderungen sind auch in der englischen Version der Dokumentation verfügbar!

Gutes Lesen und zögert nicht, mir Feedback zu geben :folded_hands: