Pausa para café #43. 6 erros de programação que impedem você de conseguir o emprego dos seus sonhos. Como contribuir para software de código aberto pela primeira vez

6 erros de programação que impedem você de conseguir o emprego dos seus sonhos

Fonte: Médio Para encontrar um emprego como programador, você precisa ter um repositório Git. Esta é uma das primeiras coisas que os recrutadores observarão. Para que seu repositório cause uma impressão positiva, ele deve conter projetos com alterações recentes. Mostre apenas projetos dos quais você se orgulha, não todas as linhas de código que você já escreveu. Este é o básico para trabalhar com um repositório. Lembre-se de que, mais cedo ou mais tarde, alguém examinará seu código para ver se você é adequado para a empresa. Este será um momento decisivo para você. Após alguns minutos, o recrutador decidirá se convidará você para uma entrevista. E aqui há boas e más notícias. A má notícia é que um simples erro pode prejudicar suas chances de conseguir o emprego. A boa notícia é que as pessoas geralmente não querem se aprofundar no código. Eles precisam de uma compreensão geral do seu código e arquitetura. Então você não precisa ser um gênio – você só precisa ser um bom programador. Aqui estão alguns erros comuns que os novatos cometem. Evite-os e suas chances de entrevista aumentarão dramaticamente.

Comentários desatualizados

Os programadores têm opiniões diferentes sobre os comentários. Alguns os amam, outros os odeiam. Não podemos chegar a uma conclusão comum sobre se vale a pena comentar o código e em que casos fazê-lo. Mas todos são unânimes em uma coisa: se você tiver comentários, eles devem corresponder ao seu código. Existem comentários para explicar o código. Quando seu código é complexo ou pouco claro, você precisa de ajuda para que os leitores o entendam. Além disso, você precisa alterar seu comentário ao alterar o código. Se você não fizer isso, seu comentário não será mais útil. Um comentário ruim é muito pior do que nenhum comentário. Para piorar a situação, os comentários são destacados no código. Os IDEs modernos destacam os comentários em uma cor diferente para torná-los mais fáceis de ler. Ao adicionar um comentário, você coloca um sinal “leia-me” no código. Desta forma, qualquer discrepância entre o comentário e o código será facilmente detectada. Escolha seus comentários com sabedoria e lembre-se de atualizá-los junto com seu código. Assim eles irão te atender bem.

Combinação de bibliotecas e linguagens com os mesmos casos de uso

Antes da primeira entrevista, tive que resolver um problema de recrutamento. Era um aplicativo da web simples, então escrevi alguns códigos, pesquisei algumas questões complexas no Google e o aplicativo estava pronto. Durante a entrevista, o recrutador me perguntou por que misturei código jQuery com JavaScript simples em todo o código. Minha resposta? “Umm...” Para ser sincero, colei alguns trechos de código do Stack Overflow. Eu não pensei muito sobre isso. O código funcionou, então segui em frente. Este erro é muito comum entre novos desenvolvedores. Estamos tão focados em resolver problemas no trabalho que não prestamos atenção em como o fazemos. Não se torne um dos novatos que cai nessa armadilha. Examine cada linha de código e certifique-se de saber por que você a colocou ali.

Repetição de código

Don't Repeat Yourself (DRY) é um dogma de programação. Criar abstrações para código repetitivo é a essência da programação. Sim, pode ser difícil no início. Quando você quer resolver um problema, você o faz de qualquer maneira possível. Então você passa para outras tarefas e o código repetitivo permanece com você. Você pode se livrar desse hábito criando um conjunto de regras para si mesmo. Cada vez que você refinar um recurso, leia o código novamente e veja se há algo que você possa fazer para alterá-lo. Lembre-se de que a primeira versão do código geralmente está errada e você pode melhorá-la. Ao notar código duplicado, reserve um tempo para estudá-lo. Dessa forma você pode descobrir a melhor maneira de reescrevê-lo (por exemplo, usando um loop ou criando uma nova função). Se você fizer essa limpeza sempre, terá um código mais confiável e elegante.

Erros não tratados

É quase impossível criar qualquer aplicativo significativo que sempre funcione perfeitamente. Esteja você preenchendo um banco de dados ou fazendo chamadas de API, ocorrem erros. Erros não tratados podem não apenas interromper a execução de funções individuais, mas podem até causar o travamento de todo o aplicativo. Antecipar possíveis erros é sinal de um programador competente. Sempre que você acessar ou atualizar quaisquer dados externos, precisará estar preparado para o pior cenário. Sinalize possíveis problemas de uma forma que não torne o aplicativo pesado. Isso permitirá que os leitores do seu código (e talvez você) encontrem erros rapidamente. Também mostrará ao recrutador que você pode escrever um código coeso.

Falta de consistência

Consistência é a marca registrada do software de qualidade. Isso torna o código mais fácil de ler e manter. O código criado em um estilo uniforme é mais previsível e mais fácil de avaliar o desempenho do programa. Em um nível mais alto de abstração, a consistência é difícil de alcançar. Levará anos para dominá-la, então você precisa começar a aprender essa técnica o mais cedo possível. Lembre-se de criar títulos usando apenas um idioma. Provavelmente deveria ser inglês, mas em projetos pessoais você pode nomear variáveis ​​e funções em qualquer idioma, desde que seja sempre o mesmo idioma. Se você for consistente, não importa se você usa tabulações ou espaços. Crie ou escolha um guia de estilo e siga-o sempre. Você também deve usar uma ferramenta como Prettier . Realmente ajuda manter o código formatado de maneira consistente. Quaisquer que sejam as ferramentas e estilos que você usar, use-os de forma consistente. Mesmo se você escrever um código incorreto em um estilo consistente, geralmente é melhor do que um código inconsistentemente bom porque é muito mais fácil de corrigir.

Incompreensão das ferramentas

Em um projeto típico, você provavelmente terá que usar alguma biblioteca externa. Muitos programadores instalam bibliotecas quase automaticamente porque elas são usadas em todos os projetos. Bibliotecas externas são ótimas porque são uma forma comprovada de resolver problemas recorrentes. No entanto, novos desenvolvedores muitas vezes não entendem quais bibliotecas estão usando e acabam adicionando uma biblioteca em cima da outra ou reimplementando algumas funcionalidades existentes. Cada vez que você instalar uma biblioteca em seu projeto, leia ou pelo menos visualize a documentação. Verifique os métodos e propriedades que você pode usar e certifique-se de entender quais problemas a biblioteca deve resolver e quais requerem o uso de uma ferramenta diferente. Desta forma, você pode escolher as ferramentas certas para o trabalho e explicar suas escolhas.

Como contribuir para software de código aberto pela primeira vez

Fonte: Jamestucker.dev Outro dia vi um tweet de Evan Yu (criador do Vue.js ) sobre um novo repositório no qual ele estava trabalhando e isso me interessou. Decidi que queria contribuir para isso! O problema é que nunca contribuí para projetos de código aberto antes e não sabia por onde começar. Mas não pode ser tão difícil, certo? Assim que entrei no repositório, congelei imediatamente. “O que diabos devo fazer?”, pensei comigo mesmo. Se eu fizer um PR (solicitação pull, solicitação de mesclagem), os especialistas provavelmente irão despedaçar meu código. Sempre serei conhecido no mundo do desenvolvimento como o cara que não sabe trabalhar adequadamente com código aberto. E minha carreira terminará. Felizmente, li um artigo (não me lembro onde) cujo autor aconselhava que sua primeira contribuição para o repositório de outra pessoa deveria ser a mais discreta possível. Isso pode ser algo tão simples quanto corrigir um erro de digitação. E foi o que fiz. Eu li a documentação do repositório, encontrei alguns erros de digitação, abri um PR e eis que Evan aprovou minhas alterações. Sou oficialmente um contribuidor do Vue! Talvez eu devesse colocar isso na minha biografia do Twitter?

"Isso é ótimo, mas como posso começar?"

Ok, vamos começar: vou mostrar passos que você pode seguir para fazer a diferença.

1. Encontre um projeto

Para se inspirar, pense na sua tecnologia ou ferramenta favorita. Digamos que você trabalhe com JavaScript e use muito o Gatsby ? Confira o repositório deles ! Você também pode contribuir para um dos meus repositórios. Aqui está uma lista dos meus projetos de front-end. Se você tem algo que adora ou acha útil, adoraria que você adicionasse! Finalmente, Awesome First PR Opportunities é um repositório gigante de projetos de código aberto para iniciantes. São projetos em 22 idiomas diferentes!

2. Decida como você pode contribuir

Confira o projeto. Leia o Leiame. Digitalize diferentes pastas e arquivos. Obtenha uma compreensão da estrutura da base de código. Ao fazer isso, você pode encontrar e corrigir facilmente o erro de digitação! Depois de fazer isso, dê uma olhada na seção Problemas do projeto. Lá você encontrará uma lista de bugs encontrados anteriormente ou recursos sugeridos. Felizmente, muitos projetos envolvem problemas voltados para iniciantes. Acho que sua primeira contribuição deve ser a mais sutil possível, mas se quiser obter reconhecimento rapidamente, a decisão é sua. Depois de encontrar algo que possa adicionar ao projeto, você precisará bifurcá-lo.

3. Criando uma bifurcação do projeto

Um fork (fork de um projeto) cria uma cópia exata dele em seu próprio repositório Github.

4. Clone o projeto localmente

Em seguida, clone o projeto em uma pasta local usando o URL do projeto.

git clone <project-url>

Aqui você encontrará o URL. Agora que o projeto está no seu computador, abra-o em um editor. Se você acha que as alterações levarão tempo, sincronize uma cópia do projeto com o original para estar sempre ciente das alterações. Você pode encontrar os comandos Git exatos para isso aqui .

5. Crie um novo branch para suas alterações

É hora de fazer suas alterações/correções! Crie um novo branch onde suas alterações entrarão em vigor.

git branch <branch-name>

Você pode chamá-lo do que quiser, mas pela minha experiência você poderá ver um padrão para nomear ramificações no projeto original. Neste caso, recomendo seguir o modelo existente. Um bom nome de branch para corrigir o erro de digitação seria patch/typo-fix . Você pode mudar para este branch usando git checkout <branch-name> . Agora faça suas alterações!

6. Abra um PR (solicitação de mesclagem)

Então você corrigiu um erro de digitação gritante ou atualizou um link quebrado. Você se orgulha do seu trabalho. Você quer que o mundo inteiro saiba que você é um daqueles desenvolvedores míticos que podem codificar, apagar e assistir Netflix, tudo ao mesmo tempo. Envie suas alterações para um repositório ramificado do Github usando git push -u origin <branch-name> . Vá para o seu repositório Github bifurcado e abra um PR (solicitação pull). Observação: se você nunca fez uma solicitação pull antes, assista a este vídeo de Kent Dodds para saber como fazê-lo. Certifique-se de que sua ramificação aponte para a ramificação master do repositório de origem. Agora você está pronto para adicionar detalhes ao seu PR. Certifique-se de que seu título transmita claramente o conteúdo do PR. Adicione uma descrição: se você estiver corrigindo um problema existente, inclua um link para ele. Assim que terminar sua descrição, envie seu PR para revisão. Quem tiver autoridade para aprovar PR provavelmente analisará sua inscrição dentro de alguns dias e fará o seguinte:

1. Mesclará as alterações imediatamente.
2. Ele solicitará que você faça alterações.
3. Fechará seu PR.

Por favor, seja paciente, pois o criador do repositório pode estar ocupado com um trabalho de tempo integral ou outros projetos.

Você fez isso!

Agora você é um contribuidor do projeto de código aberto! Como é? Pronto para construir seu próprio concorrente Node.js? Espero que, ao fazer uma simples contribuição, as perspectivas para o futuro trabalho de código aberto se tornem menos assustadoras. Para obter mais informações sobre contribuições de código aberto, consulte os guias de código aberto .