@cmaiacd
Meus primeiros passos como
mantenedora de um projeto
open-source
[email protected] - Outubro de 2020
Camila Maia
Slide 2
Slide 2 text
@cmaiacd
Esta apresentação está disponível em:
speakerdeck.com/cmaiacd
Slide 3
Slide 3 text
@cmaiacd
Motivação
Slide 4
Slide 4 text
@cmaiacd
Eu trabalho na...
Slide 5
Slide 5 text
@cmaiacd
Motivação
Slide 6
Slide 6 text
@cmaiacd
Quem sou eu?
- Desenvolvedora Backend
- Formada em Sistemas de Informação na UFSC
- Entrei na área em 2010
- Maior experiência com Python e Ruby
- Organização de eventos: PyJamas e EuroPython
Slide 7
Slide 7 text
@cmaiacd
Motivação
- Erros de integração: cliente
ou frontend
- Documentação
desatualizada
- Dificuldade em recriar
cenários
Slide 8
Slide 8 text
@cmaiacd
Slide 9
Slide 9 text
@cmaiacd
O quê a ScanAPI se propõe a fazer pela sua API?
- Framework de código aberto
- Command line interface (CLI)
- Escrito em Python
1. Fornecer uma documentação “Ao Vivo”
2. Possibilitar a implementação de testes de Integração
Slide 10
Slide 10 text
@cmaiacd
Como funciona?
- Instalar a biblioteca
- Escrever a especificação da sua API:
- Rodar a ScanAPI: $ scanapi run scanapi.yaml
- O report será gerado
Slide 11
Slide 11 text
@cmaiacd
Meus primeiros passos como
mantenedora de um projeto
open-source
11
Slide 12
Slide 12 text
@cmaiacd
Minha experiência
Muito código - PoC
Slide 13
Slide 13 text
@cmaiacd
Minha experiência
Validação da ideia
Slide 14
Slide 14 text
@cmaiacd
Minha experiência
Muita conversa com outras pessoas especialistas sobre:
open-source, arquitetura, decisões de implementação...
Slide 15
Slide 15 text
@cmaiacd
Minha experiência
Criação da Org
Slide 16
Slide 16 text
@cmaiacd
Minha experiência
Muito código - pairs e contribuições pontuais de terceiros
Slide 17
Slide 17 text
@cmaiacd
Minha experiência
Versão 1.0.0 - Divulgações: talks e mais talks
Slide 18
Slide 18 text
@cmaiacd
Minha experiência
Muitas pessoas para contribuir: aprender a gerenciar issues, projeto, criar ADRs
Slide 19
Slide 19 text
@cmaiacd
Minha experiência
Procurar mais pessoas que queiram utilizar
Slide 20
Slide 20 text
@cmaiacd
Minha experiência
Gerência do Projeto: cada vez mais. Código: cada vez menos
Dizer “não” é muito difícil! Precisando de mais gente no core-team
Slide 21
Slide 21 text
@cmaiacd
- Organização
- Sentimento de pertencimento
- Automação
- É essencial
- Diminui o trabalho manual
- Facilita a dizer não (danger, por exemplo)
- Tem que ser na dose certa: caso contrário pode dificultar contribuições
O quê aprendi?
http://opensource.guide/pt/best-practices/
Slide 22
Slide 22 text
@cmaiacd
O quê aprendi?
http://opensource.guide/pt/best-practices/
- Documentação
- Auxilia com que as pessoas saibam o quê você espera.
PRs melhores, por exemplo
- Ajuda a dizer não
- Mantém a comunicação pública
Slide 23
Slide 23 text
@cmaiacd
- É necessário estipular limites
- Pode levar ao burn-out
- Deixar claro qual é o seu envolvimento com o projeto (é
voluntário?)
- Deixar claro o nível de envolvimento dos demais membros da
org
O quê aprendi?
http://opensource.guide/pt/best-practices/
Slide 24
Slide 24 text
@cmaiacd
scanapi.dev
Slide 25
Slide 25 text
@cmaiacd
Por que colaborar com a ScanAPI?
Chega junto!
- Todas as áreas: automação, backend, front, design
- Python
- Entender como uma lib funciona
- Cobertura de testes > 90%
- Automação
- spectrum.chat/scanapi
Slide 26
Slide 26 text
@cmaiacd
Por que colaborar com a ScanAPI?
Chega junto!
How Open Source Changed My Life with Max Stoiber