Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentação para não programadores de como fazer Pull Request que usam apenas interface Web do Github #15

Open
fititnt opened this issue Sep 10, 2016 · 0 comments

Comments

@fititnt
Copy link
Member

fititnt commented Sep 10, 2016

Aqui na WebIWG, boa parte das pessoas que ajudam são não programadores, ou então programadores que não tem intimidade suficiente com git ou com as tecnologias usadas e que desistiriam antes de fazer qualquer contribuição.

O caso perfeito de exemplo, se formos falar aqui em persona (veja http://marketingdeconteudo.com/personas/) , é alguém que quer ajudar com tradução de documentos para o Textos sobre acessibilidade na Web em português e no História da Web em português. Esse tipo de persona:

  • Não é programador; Mesmo se fosse, convencer a rodar a stack completa poderia fazer a pessoa desistir
  • Saberia escrever bem e-mail ou usar Facebook; conseguiria usar Wordpress com ajuda de amigo
  • Está preocupada com tradução; ela não faz questão de aprender termos que não forem essenciais pra submeter código
  • Ela saberia ajudar se tivesse poder de escrita direto no master; mas isso é perigoso porque ela pode errar, e fazer muito estrago

A pergunta é, o que temos de documentação disponível, ou então como nós fazemos essa aproximação com alguém novo? Usamos Skype de inicio? E depois, será que podemos ter documentação por escrito, e quem sabe até mesmo vídeo curto demonstrando?

A título de referência, o primeiro artigo que aparece no Google é do @fdaciuk em http://blog.da2k.com.br/2015/02/04/git-e-github-do-clone-ao-pull-request/. Só que ele é mais completo do que a gente precisa e pode assustar as pessoas tradutoras.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant