Hallo
Ich habe in letzter Zeit einige Neuinstallationen vorgenommen.
Mir ist aufgefallen, dass die Formulierung der ersten Antwort im Prozess der Überprüfung, ob Docker installiert ist, lautet:
„Fehlgeschlagen, Docker zu finden … usw.“
Die Verwendung des Wortes „fehlgeschlagen“ als erste Antwort bei den meisten Installationen ist kein gutes Feedback für jemanden, der mit der Befehlszeile nicht vertraut ist.
Sie kopieren und fügen ein
sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
und es führt zu einem Fehler, es sei denn, Docker ist bereits installiert, was in den meisten Fällen ziemlich unwahrscheinlich ist.
Kann die Formulierung in etwas weniger Negatives geändert werden?
„Docker nicht gefunden …“
„[WIE ERWARTET] … Docker ist nicht installiert …“
„Der nächste Schritt ist die Installation von Docker, da es derzeit nicht installiert ist …“
„Das hat funktioniert! – Der nächste Schritt ist die Installation von Docker, da es derzeit nicht installiert ist …“
@pfaffman Ich weiß, dass Sie viele Installationen durchführen, haben Sie Gedanken dazu?
Ja,
ich spreche von der Befehlszeilenantwort – echo.
Kann das Wort Failed weggelassen und eine andere Formulierung verwendet werden?
Oder besser, kann die Installation einfach fortgesetzt werden und hier nicht auf eine Antwort warten?
Wenn Sie eine Installation durchführen, ist das Letzte, was Sie sehen möchten, Failed.
Besonders nachdem Sie gerade (korrekt) aus den Installationsanweisungen kopiert und eingefügt haben.
Das ist ein guter Punkt. Es gibt auch eine Reihe von grep-Befehlen, die Dinge ausgeben, die verwirrend sind und wie Fehler aussehen. Ich habe schon einmal darüber nachgedacht, das zu bereinigen. Es wird wahrscheinlich ein oder zwei Stunden dauern und ich bin etwas zurückhaltend, das in meiner Freizeit zu tun, da die meisten Leute diese beängstigenden Nachrichten ertragen können.
Wenn ich das nächste Mal Änderungen vornehme (vielleicht nächsten Monat, um die neuen Ember-CLI-Sachen leichter abschalten zu können), werde ich versuchen, diese Sprache weniger beängstigend zu machen.
Hallo Jay,
Ja, ich habe einige Installationen durchlaufen und die Panik lässt mit der Erfahrung nach.
Die verwendete Sprache spiegelt das negative Ergebnis der if-Anweisung in Zeile 131 wider.
In Codebegriffen ist dies korrekt, aber in der Realität ist es erwartetes Verhalten, Docker nicht installiert zu finden, da die meisten Leute gerade eine saubere Installation vorgenommen haben.
Ich dachte immer, dieser Code, den ich in die Befehlszeile eingefügt habe, würde Docker ohne Dialog installieren?
sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
Was hier präsentiert wird, kann leicht verhindert werden, indem Nachrichten durch Sprachzeichenfolgen ersetzt werden. Zwei mögliche Wege, dies zu erreichen:\n* Implementierung von API-Aufrufen (lesen) und Verwendung von Weblate,\n* Speicherung aller Sprachzeichenfolgen lokal (innerhalb der Discourse-Installation) und Ersetzung aller Nachrichten durch Platzhalter.\n\nBeide oben genannten Wege erfordern erhebliche Modifikationen des Discourse-Kerns.
Mir ist aufgefallen, dass die von Ihnen gewünschte Änderung nur ein paar Zeilen umfasst, anstatt all die Dinge zu beheben, die ich für problematisch halte. Deshalb habe ich Folgendes eingereicht:
Hallo Jay, danke, dass du dir die Zeit genommen hast, das zu tun. Ich weiß, dass du mit deiner eigenen Website beschäftigt bist, die übrigens großartig aussieht. Alles Gute.
Ich denke, die Erwähnung von PATH in der Nachricht ist ein wichtiger Indikator dafür, ob Docker/docker.io installiert ist oder nicht. Das Problem könnte also darin bestehen, dass PATH nicht den Speicherort enthält, an dem es installiert wurde.
Wenn das Ziel einfach darin besteht, ein stark negatives Wort zu vermeiden, denke ich, dass das Ersetzen von “Failed to” durch “Could not” ausreichen würde.
Zurück zum Negativen …
Ich muss das einfach nicht wissen … Ich möchte Docker einfach installieren, wenn ich einfüge …
Warum einen Installationsvorgang stoppen, um zu melden, dass das, was Sie installieren, nicht zuvor installiert wurde?
Machen Sie mit der Installation von Docker weiter.
Wenn Docker im PATH gefunden wird - yippee - Installieren Sie Discourse
Wahrscheinlich am besten, keine Zeit damit zu verbringen.
Mehrere Meinungen zu „Kopie“ sind schwer zu lösen, ohne jemanden zu verärgern.
Wenn ich mein nächstes Clean Install mache … kann ich über dieses Thema lächeln und zu meinem „guten Ort“ gehen und wie mir gesagt wird, dass Docker bei meiner frischen Installation nicht gefunden wurde und während ich „J“ drücke, um Docker zu installieren, kann ich es tun, ohne mit zusammengebissenen Zähnen zu fluchen: „Ich dachte, das wäre es, was ich verdammt noch mal tat – mach weiter“.
Ich denke, weil Sie Docker nicht installieren. Was Sie an diesem Punkt der Meldung tun, ist die Ausführung der Discourse-Einrichtung, die davon abhängt, dass Docker verfügbar ist – sie hilft Ihnen bei der Installation, wenn sie es nicht finden kann, fragt aber, weil sie nichts über Ihr System weiß.
Vielleicht kann sie es nicht finden, weil es nicht installiert ist, in welchem Fall die Installation offensichtlich die richtige Antwort ist. Vielleicht kann sie es nicht finden, weil Sie Docker aus irgendeinem Grund absichtlich woanders installiert haben, das sich nicht im Standard-PATH des Systems befindet, in welchem Fall die Installation die falsche Antwort ist. (Eine richtige Antwort wäre, die Einrichtung abzubrechen und sie erneut mit PATH=/wo/docker/ist:$PATH ./discourse-setup auszuführen)
Ist es möglich, dass Sie den Repository-Namen discourse_docker als Docker interpretieren? Das ist es nicht, es ist die äußere Schicht von Discourse, die Komponenten, die mit Docker interagieren müssen, wie das Setup-Skript, das Launcher-Skript usw.
