mathvbarone/awesome-programming-languages

Contribution Guideline

rafaels88 opened this issue · 10 comments

Lendo as características das linguagens até agora, eu fiquei confuso em muitas coisas. Alguns itens me pareceram muito superficiais, outros me pareceram opinião, outros eram muito genéricos. Também acho que o foco está sendo muito no processamento da linguagem e do propósito de criação dela, mas não é apenas isso que impacta diretamente uma pessoa que quer aprender uma linguagem nova. Na verdade, eu acho mais importante saber se aquela linguagem tem boas ferramentas e um bom suporte da comunidade do que saber se ela é compilada ou interpretada. E acho que o intuito do repositório é ajudar quem quer aprender uma nova linguagem, certo?

Até agora eu não tenho certeza de como contribuir com conteúdo. Não sei quais itens eu devo ter em mente pra mencionar. Não sei o que eu posso ou não posso. E pra resolver isso, acho que falta preencher esse documento aqui CONTRIBUTING.md.

Essa issue é uma proposta de discussão para ser criado um guideline para se contribuir, mas com foco no conteúdo que irá ser adicionado, e não na estrutura do Readme (isso está sendo discutido em #10 ).

Bem, vamos lá... o que deveria-se ter em mente na hora de adicionar um pró/contra para uma linguagem?

@rafaels88 acho que o @mathvbarone pode fechar a issue #10 e simplesmente deixar tudo rolando aqui, afinal criei aquela issue para estruturarmos aqueles arquivos que mandei no PR com a pasta .github. Quanto ao que virá ser discutido nessa issue de número #13, acho que deveria ser comentado a curva de aprendizado de cada linguagem, partindo do princípio, que é um assunto muito discutido nas comunidades (isso se tratando até mesmo de frameworks).

@giovannism20 Boa ideia! Vou fechar ela e trazer a discussão para cá.

Em relação ao que foi abordado pelo @rafaels88 , eu também não sei ao certo qual seria a melhor forma de abordamos esse problema, inclusive por causa disso fiz a sugestão abordada na issue #8 , em focar no problema, e não na linguagem em si.

Acho que, assim como falado na issue #14 , precisamos de mais gente com know-how das linguagens para agregar conhecimento ao repositório e achar o formato ideal a ser utilizado.

@mathvbarone Por isso estava comentando sobre colocar o exemplo da issue #8 como um "a mais" até mesmo para os iniciantes não terem a sua própria opinião e ficar dependendo da nossa.

Com todo o respeito, fica-se com a impressão de q apenas JavaScript é uma linguagem moderna e na qual vale a pena investir. C++ por exemplo, não é uma linguagem de "pouca confiabilidade". Se fosse assim sistemas operacionais como Windows e jogos de videogame modernos não a utilizariam.

Da mesma forma a descrição de Java apenas usa as descrições negativas geralmente associadas a linguagem. Ame ou odeie, é a linguagem mais utulizada hj no mundo.

De qualquer forma gostaria de contribuir. Posso submeter sugestões para as descrições do C++, Java e Kotlin?

Esse é um dos problemas deste repositório, ele e baseado em opiniões, em experiências próprias, o que pode acarretar em uma definição não confiável das linguagens.

Uma das soluções seria manter sempre essas issues sobre discussão, junto com a construção de uma opinião mais colaborativa. Teríamos que ter guidelines e nela coloca algumas regras.

@JotaPe O que acha de mandar um Pull Request para tirar um pouco dessa questão de opinião/experiência com a linguagem ?

Esse também é o objetivo do repositório, pessoas que já estão a mais tempo no mercado, falando sobre suas experiências com as linguagens...

@JotaPe dê uma olhada nas issues de número #8 && #5