Utilizando o Markdown para alavancar suas oportunidades de trabalho

Diariamente recebo mensagens privadas no LinkedIn onde os(as) desenvolvedores(as) me perguntam sobre dicas que podem auxiliá-los a terem melhores oportunidades laborais, então nessas situações, eu sempre solicito o Github para dar uma conferida, e acabo visualizando alguns erros que estão se tornando bem comuns.

O primeiro deles é deixar a maioria dos repositórios ocultos, talvez porque se sinta um pouco envergonhado(a) dos seus códigos, sentimento que não podemos ter, visto que todo conhecimento adquirido é válido, e o mais importante é demonstrarmos que estamos querendo aprender e evoluir.

O segundo erro e mais comum de todos, que vejo como muito significativo, é não colocar Readmes nos repositórios. Então se você se encaixa nessa 2º falha mais comum, esse artigo é pra você.

O que é o Markdown?

O Markdown é uma linguagem que foi criada em 2004 por John Gruber e Aaron Swarts, com a finalidade de simplificar a estruturação de um texto com símbolos como #, >, +, -, e assim podemos criar um texto ou artigo de blog, com uma linguagem que nos dará marcações bem similares ao HTML, mas escrito de uma forma bem menos verbosa(difícil), mais simplificada e visualmente mais legível.

Nesse artigo não entraremos tão a fundo em como escrever em Markdown, mas como podemos utilizá-lo para que ele nos destaque em processos seletivos, fazendo com que nossas oportunidades sejam alavancadas.

Quando estamos em um processo de seleção, temos que ter em mente que cada pequeno detalhe a mais ou cada pequeno diferencial, nos fazem ganhar pontos extras, e no final desse processo, a soma desses pontos extras podem resultar em uma contratação ou pelo menos que cheguemos em uma fase final, pois o importante não é só sermos efetivados, é todo o aprendizado que temos por trás de um processo seletivo.

Ao nos candidatarmos em uma determinada vaga, por sermos de TI os(as) recrutadores(as) sempre olharão nosso Github e LinkedIn, por isso, temos que ter em mente que esse(a) recrutador(a) talvez não entenda nada de código, então ao entrar em nosso portfólio (Github) eles devem conseguir entender qual o objetivo daquele projeto, e para isso é necessário ter uma mini documentação, que são os Readmes.md.

Os Readmes são arquivos de texto que aceitam o Markdown como linguagem de marcação, e esses arquivos servem para que você crie acessibilidade a todos(as) que estão visualizando nossos repositórios, ou seja, com essa documentação, quem visualizá-los conseguirá entender o que te motivou a criar aquele projeto, como instalá-lo, como rodar, as tecnologias utilizadas, o resultado final... São muitas opções, e toda informação a mais e com relevância que for colocada nesse Readme, pode ser um ponto extra a mais que você poderá ganhar.

Como eu já disse nesse artigo, os(as) recrutadores(as) não estão preocupados no primeiro momento se nossos códigos são escritos da melhor forma, ou se já temos um conhecimento avançado em determinada linguagem, pois nessa etapa eles(as) estão apenas triando nosso currículo, e irão analisar se iremos passar de fase ou não, então se passarmos de fase, ou formos um perfil realmente atrativo, aí sim chegará o momento técnico, onde algum desenvolvedor irá analisar o que você codou.

Temos que ter em mente que uma empresa buscará soft skills em você a todo momento, pois são elas que nos diferenciam dos demais. Então quando você coloca uma documentação, mostra que você é um(a) dev atencioso(a), que é detalhista ao ponto de escrever documentações para que todos(as) que vejam e analisem seu portfólio tenham um entendimento do que está sendo feito, e não apenas desenvolvedores(as).

Nesse processo cada pequeno detalhe importa, pois no final, a soma de todos as pequenas particularidades que você tem ao longo da seleção é o que te destaca dos demais.

Perceba que não estou dizendo que apenas com isso você será contratado(a), até porque não podemos possuir uma verdade e certeza absoluta de nada na vida, mas eu venho aprendendo que ser detalhista e demonstrar amor ao que faz, comprova aos demais que você não fez nada correndo, que está se empenhando a dar o seu máximo, e além disso, você consegue também demonstrar que possui organização e empatia por todos que acessarão seu portfólio.

Como exemplo mostro o Readme que fiz para meu repositório do blog, é um Readme simples, porém consigo dar mais detalhes do projeto e ainda mostrar o resultado final.

E aqui mostro um trecho do código do Markdown do vídeo acima:

Se você deseja saber mais sobre o Markdown e como utilizá-lo em suas documentações, deixo abaixo esses links para que você comece a aplicá-lo da melhor forma:

Como fazer um Readme bonitão - Raul Esteves

Aprenda Markdown - Fernando Daciuk

Espero que o objetivo do artigo tenha sido claro, porém, caso fique alguma dúvida ou se simplesmente você quiser bater um papo comigo, me mande uma mensagem no LinkedIn, adorarei respondê-lo(la).