Padronização de termos

ThoughtWorksInc / guia-de-desenvolvimento-tecnico

https://thoughtworksinc.github.io/guia-de-desenvolvimento-tecnico/

GNU General Public License v3.0

206 stars 44 forks source link

Padronização de termos #19

Open roberto opened 8 years ago

roberto commented 8 years ago

É bom para a leitura dar a entender que apenas uma pessoa escreveu. Então seria interessante alinharmos alguns termos entre nós. Podemos colocar algo assim na área "Contribua" depois. Além de termos para utilzarmos, coloquei quais evitar(não consegui pensar em termo melhor) para facilitar a revisão:

Alvo do documento: pessoa desenvolvedora
- Motivo: inclusão
- Evitar: Desenvolvedor, programador,
Grupo de desenvolvedores: Equipe
- Motivo: manter padrão
- Evitar: Time, Grupo
O próprio documento: este guia
- Motivo: manter identidade
- Evitar: README, documento
Sistema sendo desenvolvimento: Aplicação
- Motivo: evitar confusão com "projeto de software", "projetar". utilizar algo em português.
- Evitar: Projeto, Software

O que acham? Logicamente aberto a sugestões.

rogeriochaves commented 8 years ago

Sobre o último (aplicação), tenho dúvidas, as vezes nos referimos a "projeto" pois queremos focar mais em falar sobre a interação entre as pessoas e processos, já "aplicação" acho que seria mais falando do software em si. De qualquer forma, as vezes mudamos a palavra também pra não ficar repetitivo demais no texto.

Mas curti demais a ideia de ter uma padronização principalmente em se tratando de pontos de inclusão.

Vamos escrever de forma agênera :+1:

schmidt-marcelo commented 8 years ago

Acho legal também.

Cada um fica responsável pela sua área? Seria legal alguém se responsabilizar pela a revisão geral, que tal?

roberto commented 8 years ago

@rogeriochaves bom ponto, concordo!

Sistema sendo desenvolvimento: Aplicação
- Motivo: evitar confusão com "projeto de software", "projetar". utilizar algo em português.
- Evitar: Projeto(nesse contexto), Software, Programa, Aplicativo
A construção do sistema e seus processos: Projeto
- Motivo: ficar claro quando estamos falando dos processos envolvidos
- Evitar: Aplicação, Empreendimento, Desenvolvimento

roberto commented 8 years ago

@schmidt-marcelo opa, poderia ficar de revisor geral, mas acho melhor um par (de outra seção de preferência) para ter outra visão de cada uma.

schmidt-marcelo commented 8 years ago

Ok, cada um altera nas suas seções de responsabilidade e depois passa pelo crivo da turma. É isso?

roberto commented 8 years ago

@gomex sugestões? :)