Alterar a redação do discourse-setup

Olá
Tenho feito várias instalações limpas recentemente.
O que notei foi que a redação da primeira resposta no processo de verificação se o Docker está instalado.

"Falha ao encontrar o Docker … etc
O uso da palavra ‘falha’ como primeira resposta na maioria das instalações não é um bom feedback para quem não está familiarizado com a linha de comando.
Você copia e cola

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

e resulta em falha, a menos que o Docker já esteja instalado, o que é bastante improvável na maioria dos casos.
A redação pode ser alterada para algo menos negativo?

  • "Docker não encontrado …

  • "[COMO ESPERADO] … O Docker não está instalado …

  • "O próximo passo é instalar o Docker, pois ele não está instalado no momento …

  • "Funcionou! - O próximo passo é instalar o Docker, pois ele não está instalado no momento …

@pfaffman Sei que você faz muitas instalações, alguma opinião?

3 curtidas

Respondendo a mim mesmo… uma reflexão posterior.

É apenas uma cortesia pedir permissão para instalar o Docker?
Essa parada no processo de instalação é realmente necessária?

Poderia apenas ser afirmado que o Docker será instalado se ainda não estiver presente?

2 curtidas

Observe que essa redação não está nas instruções, é do script discourse-setup.

2 curtidas

Sim,
Estou falando sobre a resposta da linha de comando - echo

A palavra Falhou pode ser omitida e uma redação diferente usada?
Ou melhor, a instalação pode simplesmente continuar e não parar para uma resposta aqui?

Se você estiver fazendo qualquer instalação, a última coisa que você quer ver é Falhou
Especialmente depois de você ter copiado e colado (corretamente) das instruções de instalação.

3 curtidas

Esse é um bom ponto. Há também um monte de comandos grep que também vomitam coisas confusas e parecem erros. Eu já pensei em limpar isso. Provavelmente levará uma hora ou duas e sou um tanto relutante em fazer isso no meu tempo livre, já que a maioria das pessoas consegue suportar essas mensagens assustadoras.

Da próxima vez que eu fizer alterações, no entanto (talvez no próximo mês para facilitar o desligamento das novas coisas do ember-cli), verei sobre tornar essa linguagem menos assustadora.

4 curtidas

Roma não foi construída em um dia :slight_smile:

Então a limpeza pode acontecer ao longo do tempo :+1:

3 curtidas

Olá Jay,
Sim, já passei por algumas instalações e o pânico diminui com a experiência.

A linguagem usada reflete o resultado negativo da instrução if na linha 131.
Em termos de codificação, isso está correto, mas na realidade é um comportamento esperado não encontrar o Docker instalado, pois a maioria das pessoas acabou de configurar uma instalação limpa.

Sempre pensei que este código que colei na linha de comando instalaria o Docker sem a necessidade de diálogo?

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

Aparentemente, eu estava escrevendo para programadores e não para pessoas quando escrevi isso!

4 curtidas

O que é apresentado aqui pode ser facilmente evitado substituindo mensagens por strings de idioma. Duas maneiras possíveis de alcançar isso:\n* implementando chamadas de API (leitura) e usando o Weblate,\n* armazenando todas as strings de idioma localmente (dentro da instalação do Discourse) e substituindo todas as mensagens por placeholders.\n\nAmbas as maneiras acima exigem modificações pesadas no núcleo do Discourse.

1 curtida

Ocorreu-me que, em vez de corrigir todas as coisas que considero problemáticas, a alteração que você solicita são apenas algumas linhas, então enviei isto:

3 curtidas

Sinceramente, a nova redação me soa como se o Docker estivesse lá, mas apenas não estivesse no PATH.

3 curtidas

Ah, droga. Sim.

Palavras são tão difíceis.

Então talvez

Falha ao encontrar docker ou docker.io no seu PATH.

que eu pensei que faria sentido como

Nem docker nem docker.io estão no seu PATH.

Deveria ser

Docker não encontrado.

E as pessoas que veem isso e

“Pressione Enter para instalar o Docker em https://get.docker.com/ ou Ctrl+C para sair”

saberão se devem pressionar Enter ou não.

5 curtidas

Oi Jay, obrigado por dedicar seu tempo para fazer isso, sei que você está ocupado com seu próprio website, que aliás está ótimo. Tudo de bom.

Docker não encontrado.

Perfeito.

1 curtida

Eu acho que mencionar PATH na mensagem é um indicador importante se o docker/docker.io está ou não instalado, ou seja, o problema pode ser que PATH não inclua o local onde foi instalado.

Se o objetivo é simplesmente evitar usar uma palavra fortemente negativa, acho que apenas substituir “Falha ao” por “Não foi possível” faria o trabalho.

Não foi possível encontrar docker ou docker.io no seu PATH.

Voltando ao negativo…
Eu só não preciso saber disso… Eu só quero instalar o Docker quando eu colar…

Por que parar uma instalação para relatar que o que você está instalando não foi instalado anteriormente?
Continue com a instalação do Docker.
Se o Docker for encontrado no PATH - yippee - Instale o Discourse
Excluir as duas linhas completamente?

Jay, Simon

Provavelmente, o melhor é não gastar tempo com isso.
Múltiplas opiniões sobre ‘cópia’ são difíceis de resolver sem chatear alguém.

Quando eu fizer minha próxima instalação limpa… poderei sorrir sobre este tópico e ir para o meu ‘lugar bom’ e, como me disseram que o Docker “Falhou” em ser encontrado na minha instalação recente e, ao pressionar ‘S’ para instalar o Docker, poderei fazê-lo sem xingar com os dentes cerrados “Eu pensei que era isso que eu estava f…endo - Anda logo”.

1 curtida

Eu acho que é porque você não está instalando o docker. O que você está fazendo no ponto dessa mensagem é executar a configuração do Discourse, que depende da disponibilidade do docker - ele ajuda você a instalá-lo se não conseguir encontrá-lo, mas pergunta porque não sabe nada sobre o seu sistema.

Talvez ele não consiga encontrá-lo porque não está instalado, caso em que instalar é obviamente a resposta correta. Talvez ele não consiga encontrá-lo porque você instalou deliberadamente o docker em outro lugar por algum motivo, que não está no PATH padrão do sistema, caso em que instalar é a resposta errada. (Uma resposta correta seria abortar a configuração e executá-la novamente com PATH=/onde/docker/está:$PATH ./discourse-setup)

É possível que você esteja interpretando o nome do repositório, discourse_docker, como sendo docker? Não é, é a camada externa do Discourse, os componentes que precisam interagir com o docker, como o script de configuração, script de inicialização, etc.

1 curtida