search

aureliowozhiak / DLaaS

Data Lake as a Service
23 stars 6 forks source link

Documentation/pt #35

Closed Priscaruso closed 1 year ago

Priscaruso commented 1 year ago
eduwxyz commented 1 year ago

Eu vi a discussão acerca da documentação padrão ser em pt ou ser em en. Como tou entrando agora no projeto fiquei com um pouco de dúvida em qual o principal foco (I.E: Se a utilização será destinada globalmente ou a ideia é a disseminação aqui no Brasil). O ponto é: se a ideia é disponibilizar globalmente, acho interessante pensarmos em já escrever as próximas issues e até mesmo os próximos commits em en. Se a ideia é pensando aqui no Brasil mesmo, acho que não faz muito sentido ter uma documentação em inglês sendo que só traria mais atrito para pessoas iniciantes.

aureliowozhiak commented 1 year ago

Eu vi a discussão acerca da documentação padrão ser em pt ou ser em en. Como tou entrando agora no projeto fiquei com um pouco de dúvida em qual o principal foco (I.E: Se a utilização será destinada globalmente ou a ideia é a disseminação aqui no Brasil). O ponto é: se a ideia é disponibilizar globalmente, acho interessante pensarmos em já escrever as próximas issues e até mesmo os próximos commits em en. Se a ideia é pensando aqui no Brasil mesmo, acho que não faz muito sentido ter uma documentação em inglês sendo que só traria mais atrito para pessoas iniciantes.

Ótimo ponto Edu, não tínhamos pensado nisso para o projeto.

mas pra contextualizar, a comunidade do discord nasceu para ser um suporte para os brasileiros mesmo, então a ideia é se ajudar aqui dentro. Entretanto, nada impede da gente ter pessoas de fora usando os produtos, códigos e tudo o que a comunidade criar, então, pra mim o ideal é: issues e comunidades em portugues, e codigo e documentação nativamente em ingles por ser a lingua padrão de projetos de forma geral,

o que vcs acham?

Priscaruso commented 1 year ago

Eu estava pensando sobre isso também, Edu, a questão da padronização das commits, porque vi que algumas pessoas colocam em pt e outras em en. Acho que seria legal padronizar isso, se tudo mundo concordar também.

A documentação em inglês foi uma sugestão minha para o Marcos, pensando nesse alcance global da solução, mas também concordo com o Marcos que como o padrão dos projetos é inglês, então seria melhor mesmo ter os códigos e as documentações em inglês também.

Eu deixaria tudo em inglês (os commits, as issues, as documentações) kkkkkk mas se vocês acharem que vai prejudicar os iniciantes ou as pessoas da comunidade que não sabem inglês e queiram participar do projeto também, a gente pode seguir o que o Marcos falou.

eduwxyz commented 1 year ago

Ótimo ponto Edu, não tínhamos pensado nisso para o projeto. mas pra contextualizar, a comunidade do discord nasceu para ser um suporte para os brasileiros mesmo, então a ideia é se ajudar aqui dentro. Entretanto, nada impede da gente ter pessoas de fora usando os produtos, códigos e tudo o que a comunidade criar, então, pra mim o ideal é: issues e comunidades em portugues, e codigo e documentação nativamente em ingles por ser a lingua padrão de projetos de forma geral, o que vcs acham?

Nesse caso, acho viável então! Só se atentar mesmo pra a partir daqui tentar utilizar uma linguagem padrão que no caso seria o inglês mesmo, inclusive comentários no código.

Priscaruso commented 1 year ago

Ótimo ponto Edu, não tínhamos pensado nisso para o projeto. mas pra contextualizar, a comunidade do discord nasceu para ser um suporte para os brasileiros mesmo, então a ideia é se ajudar aqui dentro. Entretanto, nada impede da gente ter pessoas de fora usando os produtos, códigos e tudo o que a comunidade criar, então, pra mim o ideal é: issues e comunidades em portugues, e codigo e documentação nativamente em ingles por ser a lingua padrão de projetos de forma geral, o que vcs acham?

Nesse caso, acho viável então! Só se atentar mesmo pra a partir daqui tentar utilizar uma linguagem padrão que no caso seria o inglês mesmo, inclusive comentários no código.

Eu vi que a maioria dos códigos no repositório estão sem comentário e alguns estão em português. O que vocês acham de criar uma issue para essa padronização então?

aureliowozhiak commented 1 year ago

Perfeito gente, dá pra fazer isso, código, documentação e comentários 100% em ingles. Dá pra criar a issue sim @Priscaruso e se quiserem falar lá no discord sobre essa decisão, pra galera ficar por dentro

Priscaruso commented 1 year ago

This PR solves issue #28.