Adapterbewertungen

Unter dem Namen eines Adapters stehen im Admin bis zu fünf Sterne. Das ist keine Zierde und auch keine Beliebtheitsangabe aus dem Internet, sondern der Durchschnitt aus den Bewertungen der Nutzer, die diesen Adapter installiert haben.

?> Die Sterne im Admin sind etwas anderes als die Sterne, die man auf GitHub vergibt. Die GitHub-Sterne sagen, wie vielen Leuten ein Projekt gefällt. Die Sterne im Admin sagen, wie gut der Adapter bei denen läuft, die ihn benutzen.

Jede Installation hat eine Stimme, und sie gilt für die Version, die gerade läuft.

Wer bewerten darf

Bewerten darf, wer den Adapter installiert hat. Das ist die einzige Bedingung, und sie ergibt sich aus der Sache: Bewertet wird nicht die Idee eines Adapters, sondern wie er tatsächlich arbeitet.

Ein Konto ist nicht nötig. Die Stimme wird der anonymen Installationskennung zugeordnet, derselben, die auch die Nutzungsstatistik verwendet. Damit zählt jede Installation einmal, ohne dass jemand einen Namen hinterlassen muss.

Bewertet wird die Version

Die Stimme gilt immer für die Version, die gerade installiert ist. Ein Adapter, der vor einem Jahr Ärger machte und seitdem gründlich überarbeitet wurde, wird also nicht auf ewig von alten Stimmen nach unten gezogen.

Der Umkehrschluss gilt genauso: Nach jeder neuen Version darf erneut bewertet werden. Wer schon einmal abgestimmt hat, sieht im Dialog, für welche Version und an welchem Tag das war.

So geht es

• Im Reiter Adapter auf die Sterne unter dem Adapternamen klicken. Das funktioniert in der Kachel- wie in der Listenansicht.
• Im Dialog die gewünschte Anzahl Sterne wählen.
• Wahlweise einen Kommentar dazuschreiben, höchstens 200 Zeichen, mit Angabe der Sprache.
• Mit Bewerten absenden.

Ist der Adapter nicht installiert, öffnet sich derselbe Dialog nur zum Lesen. Die Sterne lassen sich dann nicht setzen, die vorhandenen Bewertungen und Kommentare sind aber sichtbar. Das ist der nützlichere Teil: vor der Installation nachsehen, was andere berichten.

Kommentare lesen

Der Dialog zeigt alle Kommentare, neueste zuerst, jeweils mit Sternen, Datum und der Version, auf die sie sich beziehen. Über die Auswahl Kommentare in Sprache anzeigen lässt sich auf eine Sprache eingrenzen; die Zahl daneben nennt, wie viele Kommentare es je Sprache gibt. Der eigene Kommentar ist farbig hinterlegt.

Was nicht in die Bewertung gehört

!> Ein Fehler gehört nicht in einen Kommentar, sondern in ein Issue. Der Dialog weist selbst darauf hin. Ein Kommentar mit 200 Zeichen erreicht den Entwickler nicht als Aufgabe, er steht nur da. Wie ein Issue geschrieben wird, steht unter Ein Issue eröffnen.

Sinnvoll ist die Bewertung für das Gesamturteil: läuft der Adapter stabil, tut er, was er verspricht, ist er verständlich einzurichten. Ein Stern, weil das eigene Gerät nicht unterstützt wird, hilft niemandem weiter.

Wo die Bewertungen liegen

Die Bewertungen werden zentral gespeichert und beim Öffnen des Reiters Adapter abgerufen. Ein System ohne Internetzugang zeigt deshalb keine Sterne. Einzelne Adapter können die Bewertung auch abschalten, dann fehlen die Sterne ebenfalls.