discourse-setup の文言を変更

こんにちは
最近、かなりの数のクリーンインストールを行いました。
そこで気づいたのは、Dockerがインストールされているかどうかを確認するプロセスの最初の応答の言葉遣いです。

失敗しました Dockerが見つかりません…など」

ほとんどのインストールで最初の応答として「失敗しました」という言葉を使うのは、コマンドラインに慣れていない人にとって良いフィードバックではありません。

以下をコピー&ペーストします。

sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse

そして、Dockerがすでにインストールされている場合を除いて、失敗します。これはほとんどの場合、非常にありそうにありません。

言葉遣いを、もっとネガティブでないものに変更できませんか?

  • 「Dockerが見つかりません…」

  • 「[予想通り] … Dockerはインストールされていません…」

  • 「次のステップは、Dockerが現在インストールされていないため、Dockerをインストールすることです…」

  • 「うまくいきました!- 次のステップは、Dockerが現在インストールされていないため、Dockerをインストールすることです…」

@pfaffman 多くのインストールを行っているとのことですが、何か考えはありますか?

「いいね!」 3

自分で返信…後からの考えです。

Dockerのインストール許可を求めるのは単なる儀礼ですか?
このインストールプロセスの停止は本当に必要ですか?

Dockerがまだインストールされていない場合はインストールされると述べればよいだけですか?

「いいね!」 2

この文言は指示書にはありません。discourse-setup スクリプトからのものです。

「いいね!」 2

はい、
コマンドライン応答の echo のことですね。

「Failed」という単語を削除して、別の表現を使うことはできますか?
あるいは、インストールが停止せずに、ここで応答を待たずに続行することはできますか?

インストールを行う際に、最後に表示されたくない単語は「Failed」です。
特に、インストール手順から(正しく)コピー&ペーストした直後ではなおさらです。

「いいね!」 3

それは良い点ですね。grep コマンドにも、混乱を招くような、エラーのように見える出力がたくさんあります。以前から、それを整理しようと考えていました。おそらく1〜2時間かかるでしょうし、ほとんどの人は those scary messages に耐えられるので、自分の時間を使ってまでやる気にはなれません。

しかし、次回変更するとき(新しい ember-cli のものを無効にしやすくするために、来月あたりかもしれません)には、その言語を less scary にする方法を検討します。

「いいね!」 4

ローマは一日にし できなかった :slight_smile:

だから、クリーンアップは時間をかけて行うことができます :+1:

「いいね!」 3

ジェイさん、こんにちは。

はい、何度かインストールを経験しましたが、経験を積むにつれてパニックは収まります。

使用されている言語は、131行目のif文のネガティブな結果を反映しています。
コーディングの観点からは正しいですが、実際には、ほとんどの人がクリーンインストールを行ったばかりなので、Dockerがインストールされていないことを期待される動作です。

コマンドラインに貼り付けたこのコードで、対話なしでDockerがインストールされるはずだとずっと思っていました。

sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
「いいね!」 2

私がそれを書いたとき、プログラマー向けであって、一般の人向けではなかったようです!

「いいね!」 4

ここで提示されているものは、言語文字列にメッセージを置き換えることで簡単に回避できます。これを達成するための 2 つの可能な方法:

  • API 呼び出し ( read ) を実装し、Weblate を使用する。
  • すべての言語文字列をローカル ( Discourse インストール内 ) に保存し、すべてのメッセージをプレースホルダーに置き換える。

上記のどちらの方法も、Discourse コアの大幅な変更が必要です。

「いいね!」 1

問題だと思っているすべてのことを修正するのではなく、あなたが要求した変更はわずか数行なので、これを提出しました。

「いいね!」 3

率直に言って、新しい言い回しは、Dockerはそこにあるが、パスにはないように聞こえます。

「いいね!」 3

ああ、しまった。ええ。

言葉はとても難しいです。

だから、おそらく

PATHにdockerまたはdocker.ioが見つかりませんでした。

これは次のように意味をなすと思ったのですが

PATHにdockerもdocker.ioもありません。

は次のようになります。

Dockerが見つかりません。

そして、それを見て

https://get.docker.com/からDockerをインストールするにはEnterキーを押すか、終了するにはCtrl+Cを押してください」

リターンキーを押すべきかどうかわかるでしょう。

「いいね!」 5

ジェイさん、こんにちは。お忙しい中、お時間をいただきありがとうございます。websiteも素晴らしいですね。よろしくお願いいたします。

Dockerが見つかりません。

完璧です。

「いいね!」 1

PATH をメッセージに含めることは、docker/docker.io がインストールされているかどうかの重要な指標になると考えられます。つまり、問題は PATH にインストール場所が含まれていないことである可能性があります。

否定的な言葉を避けることが目的であれば、「Failed to」を「Could not」に置き換えるだけで十分だと思います。

PATH 上で docker または docker.io が見つかりませんでした。

ネガティブな方向に戻って…
これを知る必要はありません…貼り付けたらDockerをインストールしたいだけです…

インストールしようとしているものが以前にインストールされていなかったことを報告するためにインストールを停止するのはなぜですか?
Dockerのインストールを進めてください。

PATHにDockerが見つかったら - やった - Discourseをインストールします

2行を完全に削除しますか?

ジェイ、サイモン

これに時間を費やすのはおそらく最善ではないでしょう。
「コピー」に関する複数の意見は、誰かを不快にさせることなく解決するのは困難です。

次にクリーンインストールするとき…このトピックについて笑顔になり、「良い場所」に行き、指示されたようにDockerが私のクリーンインストールで見つからなかった場合、Dockerをインストールするように「Y」を押すと、歯を食いしばりながら呪うことなく行うことができます。「それが私がやっていたことだと思ったのに、さっさとやれ」と。

「いいね!」 1

Dockerをインストールしているわけではないからだと思います。そのメッセージが表示された時点で実行しているのは、Dockerが利用可能であることを前提とするDiscourseのセットアップです。Dockerが見つからない場合はインストールを支援しますが、システムについては何も知らないため、質問します。

見つけられないのは、インストールされていないためであり、その場合はインストールが正しい答えです。あるいは、何らかの理由でDockerをシステムのデフォルトPATH以外の場所に意図的にインストールしたため見つけられない可能性もあり、その場合はインストールは間違った答えです。(正しい答えの1つは、セットアップを中止し、PATH=/where/docker/is:$PATH ./discourse-setup を実行して再度実行することです。)

リポジトリ名 discourse_docker をDockerと解釈している可能性はありませんか?それはDockerではなく、セットアップスクリプトやランチャースクリプトなど、Dockerとやり取りする必要があるコンポーネントであるDiscourseのアウターレイヤーです。

「いいね!」 1