
## Prioridades

No início da minha carreira, perdi boa parte do meu tempo investindo em freelancing. Ainda não tinha descoberto, ou apenas realizado a importância da colaboração em projetos Open Source. Talvez por falta de incentivo, ou até mesmo por precisão financeira.

Sempre utilizei GIT para versionar meus projetos. A pouco mais de 1 ano comecei a embarcar nesse mundo, fiz novos amigos, conheci pessoas incríveis, aprendi muito. Passei a perceber que consegui adquirir tanto conhecimento lendo e revisando código de outros desenvolvedore.

Após participar de vários projetos. Incrivelmente a quantidade de contribuidores vem crescendo muito, e alguns que querem ajudar não sabem bem como começar, ou como contribuir da forma correta. Resolvi então criar este tutorial com algumas dicas que utilizo no dia-a-dia.

<img src="/content/images/articles/git-commit-graph.png" alt="Git commit graph" />

## O que é Open Source?

O termo Open Source (Código aberto em português), diz respeito a software de com código aberto, transparente e de forma colaborativa. Significa que você pode ter um executável final do projeto e também ter acesso ao código fonte de como esse executável foi produzido. Uma vez tendo acesso ao código fonte, é possível compreender como o software foi produzido e o mais importante, é possível modificar, solucionar problemas e adicionar novas funcionalidades. Um grande exemplo é o Kernel do Linux, que teve a contribuição de milhares de desenvolvedores.

## Por que eu deveria contribuir?

A maioria das vezes se resume no sentimento de solucionar um problema, publicar e ver sua solução sendo utilizada por centenas, milhares, ou até milhões de pessoas. Isso é realmente incrível!
Mas não é só isso, contribuindo você pode:

* Melhorar seus conhecimentos de desenvolvimento.
* Aprender com outros desenvolvedores.
* Praticar e/ou aprender determinada tecnologia que você esteja querendo aprender/melhorar.
* Criar sua presença online! Nada melhor do que se tornar relevante na hora de procurar um novo emprego.

## Quero ajudar mas não sei qual projeto contribuir e por onde começar

Atualmente enquanto escrevo esse post, o Github na minha visão é a maior rede de projetos open-source do mundo. São mais de 5 milhões de projetos abertos crescendo a cada dia e esperando ajuda de novos desenvolvedores.

Não basta saber a existência dessa vasta quantidade de projetos. É preciso se identificar com algum. A primeira etapa é procurar um projeto interessante para você. Um projeto que talvez você use diáriamente, e que possivelmente tenha achado algum bug. Talvez até algo que lhe traga interesse e que você queira se aperfeiçoar mais. Geralmente um outro desenvolvedor pode pedir sua ajuda por achar o seu conhecimento o suficiente para resolver determinados problemas. Essa é a magia em ter uma grande comunidade.

Após escolher um projeto, caso não saiba por onde ajudar, alguns projetos tem uma espécie de ROADMAP (Lista de funcionalidades desejáveis). Nessa lista você pode identificar o que está faltando ser implementado no projeto.

Existem algumas formas de procurar um projeto interessante no qual você possa se identificar:

* [Codetriage](http://www.codetriage.com/) – Na minha visão uma plataforma visionária! Você fala qual projeto gostaria de contribuir, e recebe algum email com algumas tarefas que precisam de ajuda.
* [GitHub Explore](https://github.com/explore) – Lista de projetos populares no Github.
* [GitHub Collections](https://github.com/collections) – Projetos listados a partir dos interesses do desenvolvedor.

## Coisas para se conhecer antes de entrar em um projeto

Atualmente sou mais ativo na comunidade ruby e javascript, ao longo do tempo conversando com outros desenvolvedores e usando vários projetos Open Source, percebi algumas características que me fazem perceber quais projetos são mais seguros e tendem a evoluir melhor como requisito para utilização em meus projetos.

## Comunidade: Um por todos e todos por um

Um projeto tende a crescer adequadamente quando possui uma boa comunidade, desenvolvedores, designers, formadores de opinião. Todos são bem-vindos e cada um contribui como pode, o importante mesmo é ajudar e fazer com que o projeto cresça da melhor forma possível.

Existem algumas divisões no processo de colaboração:

* **Owner**: Usuário que criou o projeto. Geralmente com acesso completo para edição e integração do projeto.
* **Maintainers e Collaborators**: São usuários muito ativos no projeto. Geralmente dão a direção e orientam contribuidores para que o projeto tome o caminho ideal. Tem acesso de escrita no repositório, porém normalmente segue o fluxo normal de contribuição com Pull Request.
* **Contributors**: Contributors (Contribuidores) são todos os usuários que já fizeram um pull request (contribuição) que foi aceita e mergida ao projeto.
* **Community Members**: São todos os usuários que tomam conta e contribuem de alguma forma para o projeto, seja discutindo, requisitando novas funcionalidades, contribuindo com código e até palestrando.

## Organização(Team)

Após um certo nível de maturidade, os Owners de projetos geralmente criam organizações. Tirando assim o vínculo direto do projeto ao seu perfil de usuário no Github e criando uma organização para representar todos os repositórios relativos ao projeto. Ex:

<img src="/content/images/articles/github-org.png" alt="Github org" />


Além das divisões normais, cada Organização pode ter sua própria nomenclatura para os tipos de Contribuidores do projeto, veja o exemplo abaixo:

<img src="/content/images/articles/team-org.png" alt="Team org" />

## Documentação: Disseminando conhecimento sobre o projeto, ensinando novos usuários
Um bom projeto permite que novos usuários tomem conhecimento facilmente das funcionalidades e requisitos para utilização. Utilizamos vários recursos de documentação para essa finalidade.

## Readme

Geralmente quando você cria um projeto no Github ou Bitbucket eles sempre oferecem a criação inicial do arquivo README.md. O .md representa a sintaxe markdown, se você não sabe como utilizar, sugiro ler o post “[Adicionando Markdown ao seu kit de sobrevivência na web](https://medium.com/@pragmaticivan/contribuindo-em-projetos-open-source-utilizando-git-parte-1-d2b160e0abb5)”. O readme oferece a descrição básica do projeto com detalhes de como usar, compilar ou até como contribuir e acompanhar o projeto.

## Contributing

O arquivo CONTRIBUTING lista uma breve documentação de como contribuir com o projeto. Recentemente o Github criou uma funcionalidade que integra este arquivo ao processo de Pull Request e criação de Issues. Ao iniciar a criação de uma issue, será possível ver um alerta sugestionando uma leitura no guia de contribuição do repositório:


<img src="/content/images/articles/contributing.png" alt="Contributing" />


## License

O arquivo LICENSE representa o tipo de licença do projeto. Geralmente projetos Open Source informam aos usuários e contribuidores o que eles podem e não podem fazer no projeto (usar, modificar, redistribuir, etc). Existem vários tipos de licenças, você pode descobrir qual se encaixa melhor no perfil do seu projeto no site choosealicense.com.

## Documentação e Wikis

Geralmente projetos iniciam apenas com sua documentação no arquivo README. A medida que o projeto cresce é necessário criar outras formas de documentação. Geralmente incluindo em uma pasta /doc. Ou criando páginas WIKIs. WIKIs são recursos providos pelo Github ou Bitbucket para que se possa criar documentações simples e navegáveis.

## TO BE CONTINUED…
Até então você conseguiu aprender bastante coisa sobre o mundo Open Source. Em breve tem mais novidades, acompanhe o blog! Nos vemos logo mais.


Um guia prático sobre como contribuir para projetos utilizando git e github

Contribuindo em projetos Open Source utilizando git [parte 1]


> How many professionals' influence has helped me become who I am today.

Many factors can influence how we overcome obstacles in our life. Such challenges typically happen when we face many uncertainties, providing us with choices that can change how our lives can be.

Many of our victories can be dedicated to all the mentors we have known throughout our lives, who have somehow helped us by guiding the path we have decided to pursue without asking for anything in return. Subliminally, with many times the desire to see you overcome your obstacles and walk a path to victory.

A simple gesture of effort to show how something works; a minute dedicated to suggesting something to read, an encouraging lecture to never give up, or even a piece of advice on avoiding some troubles can be something many of us can do.

## For those who don't know where to go, should any destination be good?

<img src="/content/images/articles/tomorrow-highway.jpeg" alt="Tomorrow Highway" />

I remember just like it was yesterday, the day I got to play with my `first` computer. I've always been a curious guy, especially when it had to do with technology. My dad's friend helped me configure everything, and I started using/learning it all as much as possible.


For a long time, this friend helped us to format/install our computer when it was slow or abducted by víruses (LOL). That was the time I started thinking about doing that as a professional.

I learned with a friend the step-by-step of how to install and configure a computer, and it got me very interested in how everything worked. At eleven years old, I decided that I wanted to study way more than I was able at that time. Nothing is easy when you're a fellow who lives in a small city, which is also located in a small state. Believe it or not, I could find myself waiting until midnight to start using the internet with my Old fashion modem. I was the little IT kid in the block for many years, which never stopped me from having dreams about something more significant.


Sometimes I keep thinking about what would have happened If I hadn't met those people who certainly had a significant influence in my life to keep pursuing more knowledge. Have you stopped to think about what would *you* be without people like that in your life?


Nowadays, many people don't know what to do before starting a university degree. Usually, when they think about something, they are not really sure of what is the real meaning or what happens in a profession.

I have been influenced by people close to me, but not everyone is so lucky. I hope one day it will be better introduced in our education system.


## Sometimes, we just need a little push

<img src="/content/images/articles/bike-learning.jpg" alt="Bike learning" />

They say that developers acquire what's called Impostor syndrome throughout their life. I can say that I had that even before I started. Even though people would say the opposite, I always thought anything I did was not good enough to show to someone. Many times, even close people would not appreciate it enough in many attempts.

In my university, sometimes we got the opportunity to attend some programming events, and that was when I met one of my old friends, `Juarez Filho`.

Maybe he doesn't know that until he reads this post, but my first programming internship had some contributions from his actions in my university. I remember being very insecure about participating in a CakePHP course because I was not feeling terrific about PHP and needed a little push (encouragement) to attend the class.

After this day, I never stopped. I've studied more and more and ended up getting two internships because of that workshop. Many people are responsible for many choices I took, many successful choices, but some very unfortunate. Even though, it certainly contributed to how I make my decisions, helping me improve the way I can think about situations and how to choose a good path for my life.

If we have more guides like those people, the community will provide better professionals with a better attitude. Attitudes can help other people with the "little push" they may need without expecting anything back. Something that, in the end, is extremely rewarding.

## If life gives you a lemon, make a caipirinha!

<img src="/content/images/articles/caipirinha.jpeg" alt="Caipirinha" />

Nothing was easy; unfortunately, I was from another city, my internship was in the state capital, I had to move consequently, not knowing many people. Before that, I always had to go to college by bus, it was an average of 1 and a half hours to go and an hour and a half to get back, a lot to discourage.

I can say that one of the most decisive moments that totally contributed to my career was in my second internship. I was about seventeen, I think. The company owners (now friends) were at a level above the market. My internship assignment was not so trivial (haha). Stuff like: "Document this framework into object-oriented PHP in English, then create a template system in Smarty and generate the framework documentation."

Just imagine, I did not know any English, I was beginning to understand object orientation, and finally, Smarty was all in English and very complicated at the time. I felt pretty discouraged at the time.

I spent hours reading to "decipher" what I was doing wrong. I worked with maintenance and computer networks for a long time, so finally, I even thought about giving up programming because I thought I was terrible at it.

Luckily I was always mentored by the two partners of the company, which made me better understand the whole process and how to do each task. Finally, when I finished, I felt very happy. I never thought to do anything like this or work with a framework created by the company.

Sometimes I stop to think about what I would have done if my bosses had not helped me and understood I was having some trouble. Would I have continued with software development?

## Conferences, conferences, conferences, conferences!

"Dang! This person leaves their home so they can help folks in another city and does not get paid for it". I've heard a lot of people say that, sadly.

People need to learn the value they do not have by networking and listening to someone with experience speaking at events. Such people have gone through difficult times trying to solve a certain problem in a particular domain that will often save you from going down the same painful path.

In events, I met people who for many times contributed in a great way to the professional that I am today. And luckily, they got me some really nice jobs (hehe).

<img src="/content/images/articles/devfest.jpeg" height="500px" alt="DevFest" />

So get out of your comfort zone and invest in communication and learning, because if you are not seen, you are not remembered. Nothing will be easy if you don't leave your house to meet people and learn from all these experiences.

As one of the organizers of one of the biggest events in my state (Alagoas Dev Day), I know how difficult it is in Brazil to do something like this.

So when I know of some interesting event that fits in my pocket I always try to go. In the events that I attended I saw many opportunities to appear, I met extraordinary people and consequently many people sharing very interesting stories that surely would never know if I had stayed at home.

> Keep calm and let’s go!

## Be a guide and help to create the next generation that will change the world

<img src="/content/images/articles/abound.jpeg" alt="Abound" />

I'm happy for today (even with so many craps) programming communities have been growing a lot, and several mentors have been appearing every day. A simple gesture of help and guidance can contribute to a better career path for many people.

I try hard to contribute with career guidance from many friends and even in the life of those who have not yet decided what to do in life, showing at least what can happen if this person is in the programming area. Often with projects like the Remote Work Guide, or just with information on how I currently work.

Sporadically people just need that older brother's sermon to talk about what's wrong and how to get better. I feel that a lot of them have grown a lot like professionals after that and in a way, it's very gratifying for me.

It is quite clear that I will not be able to create a revolution yet, but I am doing my part. So if you know a little, or have enough experience to help someone, do not think too much help! The feeling you have of seeing someone you helped succeeding is indescribable. In a way, you are helping to create a new generation that will change the world!


How the influence of many professionals have helped me to become who I am today.