Imagem expressando uma dúvida sendo processada em ideia e execução

O que eu devo saber para escrever artigos?

Leonardo Vilarinho
Training Center
Published in
5 min readMay 5, 2018

--

A cada dia vejo mais interesse entre os desenvolvedores quando o assunto é compartilhamento de conhecimento, seja por meio de artigos, vídeos e/ou outros. Mas sei que sempre existe aquele velho cagaço:

Será que o pessoal vai curtir meu conteúdo? Ou vou ser ‘hateado’ até o limbo da internet?

Se você ainda se encontra com essa perturbação em mente, esse artigo é para você! Nele vou contar um pouco de como comecei a compartilhar meu conteúdo e tentar distribuir um conceito para que você tire esse cagaço da sua vida.

É impossível dar uma lista de dicas e dizer que se você segui-la fielmente terá sucesso em sua jornada. Até porque nada no mundo é desse jeito, mas é sempre mais fácil!

A imaginação é mais importante que o conhecimento. — Albert Einstein

Essa frase poderia muito bem ser todo o corpo deste artigo, pois você não precisa saber muito sobre um assunto para compartilha-lo, basta ter a vontade de espalhar aquilo e imaginar que poderá ajudar alguém a agregar.

Alguma criatura pode rebater esse pensamento com um simples “eu não leria um artigo de uma pessoa que não domina o assunto”, pois então, essa criatura não deveria estar lendo esse artigo e nenhum outro de tecnologia, pois a área está em evolução constante, então mesmo se a pessoa ficasse igual uma coruja no feed sobre o assunto não o dominaria.

Cabe ao bom senso quando você lê um conteúdo, fazer a filtragem entre coisas que lhe agregam das coisas que lhe distraem, pois praticamente em 99,9% das vezes, nem todo o conteúdo irá lhe agregar em algo.

Tendo isso em mente, você já até poderia parar de ler esse artigo e escrever o seu próprio, pois até esse ponto espero que você já esteja com um pensamento que seja qual for seu conteúdo, ele irá agregar para com outro.

Mas caso ainda queira continuar a leitura… A seguir falarei um pouco de como comecei a escrever conteúdo e no final deixarei alguns detalhes que podem lhe ajudar.

Imagem da reunião (vazia) de devs e usuários de Windows Phone

Comecei a publicar textos em meados de 2015, com uns 18 anos de idade, curiosamente no mesmo momento em que aprendi programação. Na época usava Windows Phone e queria muito criar aplicativos nativos para a plataforma, então depois de passar uma semana esperando o download do Visual Studio acabar, iniciei minha jornada.

Era uma mineração constante de conteúdo na internet, acoplamento e complexidade ciclomática lá no talo e coesão zero. Mas eu estava ali aprendendo, e a cada coisa nova que conseguia fazer era só alegria.

E foi essa alegria que me fez ter a ideia de compartilhar meus primeiros artigos, criei um blog no Wordpress mesmo e comecei a publicar coisas sem muito conhecimento, como exemplo: “Como fazer menu hamburger”, “Manipular gestures”; E a qualidade do código lááááá no chão…

Para minha surpresa, mesmo sem anunciar, os leitores começaram a vir e aquilo me deixou muito feliz, mas eu comecei a sair da plataforma… era o PHP (❤) me sugando.

Depois desse período fiquei um tempo mergulhado no universo do PHP e freelancer, sem publicar nada. Até que veio o Vue.js (❤❤) e a oportunidade dada pelo Vedovelli ao doar o espaço do Vue.js Brasil para eu escrever minhas imaginações lá.

Antes mesmo de aprender a metade da biblioteca eu já estava publicando conteúdo sobre alguns plugins básicos que desenvolvi, hoje esses plugins têm cerca de 100~250 stars (cada) no GitHub, mesmo com código de qualidade duvidosa.

Coincidentemente, nesse exato momento, eu estava começando a participar de projetos de pesquisa e iniciando o meu TCC na faculdade, o que me deu um ganho enorme no nível da minha escrita.

Aproveitando esse ganho, subi o nível da linguagem em meus artigos e comecei o projeto com a Casa do Código para escrever o livro Front-end com Vue.js.

E hoje estamos aqui, sempre que estou aprendendo ou me aprofundando em algo, eu escrevo um ou mais artigos sobre, assim como foi com o TDD em API, testes e2e e outros. E como estou brincando com o Vue.js no trabalho e integrando o desenvolvimento com o Shell Script (porque sou preguiçoso), provavelmente teremos conteúdo sobre isso.

Para finalizar este pequeno artigo, vamos a um bate bola simples, mostrando porque você deveria sair do processo de dúvidas e botar suas ideais pra todo mundo ver!

Porque devo escrever?

  • Ao escrever, você vai estar ampliando seus próprios conhecimentos e ensinando outras pessoas, seja com seus erros ou suas novas ideias.
  • Criar conteúdo online é uma ótima maneira de ter um espaço para pesquisar algo que você não se lembra mais.
  • Receber críticas e feedbacks irá te dar um grande review do seu valor para o mercado.
  • Pode ser que escrever se torne suas metas, por exemplo: ‘devo estudar arrow functions para criar um artigo explicando quando usa-las ou não’.
  • Compartilhando você se espalha como um vírus para as comunidades, deixando sua marca em outras vidas, o que pode se tornar um ciclo e te beneficiar futuramente.

O que devo já saber?

  • Lidar com críticas, sejam positivas ou negativas é essencial para seu crescimento e boa aceitação do seu conteúdo.
  • Tenha atenção com descrições de imagens e termos usados, para que qualquer pessoa se sinta bem-vinda, independente de sua situação fisíca, moral, intelectual...
  • Modere na linguagem, ainda entrando no assunto de inclusão, para que qualquer pessoa se sinta à vontade, use uma linguagem neutra, nem tão formal nem tão informal.
  • É essencial tomar cuidado com conteúdo de terceiros, sem ficar copiando dos coleguinhas, e quando tiver necessidade disso, certifique-se de citar a fonte e/ou pedir permissão.
  • Revise, revise, revise! Leia e releia seu texto, sinta-se com vontade de ler ele, pois se nem você se interessa pelo assunto, quem vai?

Em resumo, o artigo não respondeu o que a pergunta se subentende, mas teve o intuito de mostrar que essa pergunta está errada, e deveria ser “Porque ainda não estou compartilhando o meu conteúdo?”.

Como você pode ver, eu mesmo ainda sou um bosta na maioria das coisas, mas estou aqui expondo minha imaginação e deixando aberto um espaço para feedbacks, pois acredito e tenho a certeza que algumas pessoas irão crescer com esse texto.

Então finalizo com uma só frase: se toda coisa ruim tem o seu lado bom, então mesmo um conteúdo ruim vai agregar para com alguém!

--

--

Leonardo Vilarinho
Training Center

Analista de Sistemas pelo Instituto Federal do Triângulo Mineiro