diff --git a/translation/portuguese-script.md b/translation/portuguese-script.md new file mode 100644 index 0000000..d525c64 --- /dev/null +++ b/translation/portuguese-script.md @@ -0,0 +1,386 @@ +**Como contribuir para o NumPy \- Texto** + +**Página 1** + +“Na universidade de Monty” + +Alice: “Ufa, estou tão feliz que terminamos a aula de laboratório.”, +(Alice está aliviada após uma bateria de aulas de laboratório.” + +Bob: “Maaas não terminamos ainda.” +(Bob lembra Alice que ainda tem mais trabalho para ser feito.) + +Alice: “Precisamos analisar os dados de imagem das células, certo? Com NumPy?” +(Alice está se referindo a analisar dados de uma imagem de células usando o NumPy, indicando que estão trabalhando em algum processamento de dados científicos.) + +Alice: “Sim… E eu não faço a mínima ideia de como usar o NumPy. Então agradeço por virem depois da aula me ajudar.”, +(Alice admite que não sabe usar o NumPy e expressa gratidão por virem ajudá-la.) + +Chris:”Sem problemas\! A gente fica feliz em ajudar. Já mexi com o NumPy em uma aula de ciência da computação.” +(Chris está confiante e tranquiliza Alice, mencionando experiência prévia com NumPy em outro contexto (ciência da computação).) + +**Página 2** + +Alice: “Você se lembra do que fizemos no laboratório certo ?”, + +Bob: “Sim, nós terminamos de tingir as células.”, + +Alice: “Então agora todas as informações das imagens das células estão compactadas em um arquivo zipado. Portanto, usamos o NumPy para extrair o arquivo.”, +(Alice explica que as imagens das células estão comprimidas em um arquivo, e o NumPy vai ser usado para lidar com a extração.) +\[Tingimento, escaneamento, Imagens, Compactação, arquivo npz, Descompactação\] + +Bob: “Matrizes ? Como uma imagem pode ser um bando de números ?” +(Bob está confuso em como uma imagem pode ser representada por uma matriz de números.) + +Chris:” Nos não podemos abrir a imagem… como uma imagem? Ver com nossos olhos ?”, + +(Chris pergunta por que não podem ver a imagem diretamente em vez de lidar com matrizes.) + +Alice: “Bem, na pesquisa de microbiologia, estamos analisando muitas e muitas imagens de células. E com a matriz do NumPy(ndarray) nós podemos analisar e processar muito mais rapidamente do que fazendo manualmente, imagem por imagem.” +(Alice esclarece que na pesquisa, muitas imagens precisam ser processadas, e usar os ndarrays do NumPy acelera este processo) + +Bob: “Eu posso trabalhar com 3 imagens. ”, + +Chris: “Mas 400 imagens? De apenas uma aula de laboratório ?” + +Bob: “Hmm. Isso faz sentido, eu presumo.”, + +**Página 3** + +Chris: “Ok\! Então por onde começamos ?”, + +Alice: “Vamos começar criando um arquivo python.”, + +Alice: “No arquivo, vou começar importando o NumPy.”, +(Alice está explicando o passo inicial de iniciar um script Python importando a biblioteca NumPy.) + +Alice: “Nosso professor deu as imagens das células em um arquivo .npz chamado cell\_images.npz.” +((Alice explica que eles receberam as imagens das células em um arquivo compactado do NumPy (formato .npz).) + +Alice: “Vamos combinar a função np.load() com cell\_images.npz.”, +(Alice introduz o uso do NumPy para abrir um arquivo .npz) + +Alice: “E este é nosso arquivo .npz aberto” +(Alice aponta o conteúdo do arquivo após usar np.load().) + +Bob: "Ótimo\! Mas... são muitos arquivos. Como vamos saber qual é o nosso?" +(Bob está confuso com as várias entradas de dados no arquivo carregado e se pergunta como identificar a correta.) + +Chris: “Você tem razão. Eu quero minhas imagens de células do laboratório das 10h.” + +Bob: "'npzfile A' não me diz se isso é do laboratório das 10h ou das 15h." +(Bob está frustrado porque o nome do arquivo não esclarece a qual sessão de laboratório os dados pertencem.) + +Alice: “Isso parece um dicionário, vamos usar a função Keys.. ” +(Alice propõe usar a estrutura semelhante a um dicionário do arquivo para inspecionar suas chaves e identificar os dados corretos.) + +Chris: “Dicionário ? Chaves ?”, +(Chris não tem certeza de como os dicionários funcionam nesse contexto.) + +Bob: "Entendi. Como estou vendo keysview, isso é de fato um objeto semelhante a um dicionário.", +(Bob confirma que o arquivo .npz carregado se comporta como um dicionário após inspecionar as chaves.) + +Alice: "Os atributos do objeto 09-09-10AM..." + +Bob: "Vamos mudar nossa abordagem. Vamos usar a função list() para transformar tudo isso em uma lista adequada.", +(Bob sugere converter as chaves em uma lista para facilitar o manuseio dos dados.) + +Bob: "Agora transformamos nossos arquivos .npz em uma lista de objetos\! A lista de objetos é uma lista de nossas sessões de laboratório." + +Bob: "Cada sessão de laboratório é um objeto também. Eu quero ver as imagens do objeto 09-09-10AM." + +Alice: "Vamos ver todos os nomes dos arquivos dos objetos 09-09-10AM... Pronto\! Agora temos as imagens das células capturadas durante nosso laboratório das 10h \!" +(Alice encontra os dados relevantes após listar as chaves e identifica as imagens corretas.) + +**Página 4** + +Chris: "MAS—QUE—?\!" + +Bob: "Por que você não consegue ver o nome do arquivo bem ali?" +(Bob está frustrado porque os nomes dos arquivos não estão visíveis.) + +Chris: "Você disse que o NumPy deveria ser mais rápido\! Melhor do que fazer manualmente\!" +(Chris está chateado porque o NumPy não está facilitando a tarefa.) + +Alice: "Quer dizer, eu esperava que o keysview me dissesse o nome do arquivo. Mas, na verdade, ele não diz." +(Alice está explicando que o keysview não deu o resultado esperado.) + +Bob: "Então você precisa contornar essa estranheza\!" +(Bob incentiva Alice a encontrar uma solução para o problema.) + +Alice: "Posso contornar isso, já que sei como inspecionar objetos..." + +(Alice assegura que sabe como lidar com a situação, apesar do problema.) + +Chris: "Mas ei, tudo bem desde que funcione." + +(Chris tenta minimizar o problema, focando na funcionalidade.) + +Bob: "Não acho que devamos aceitar 'desde que funcione\!' Isso torna nossas vidas mais difíceis\!" +(Bob se opõe, afirmando que não devem se contentar com soluções subótimas.) + +Chris: "Você está certo. É difícil, mas podemos mudar isso\!" +(Chris concorda com a perspectiva de Bob e expressa esperança por melhorias.) + +**Página 5** + +Alice: “NumPy é um projeto de código aberto. Qualquer um pode contribuir ou mudar o código base. Mesmo como estudantes de pós-graduação, podemos fazer sugestões, como tornar mais fácil a abertura de arquivos .NPZ. E então, outras pessoas podem desenvolver essa sugestão e transformar essa funcionalidade em realidade\! ” +(Alice explica que a natureza de código aberto do NumPy permite que os usuários aprimorem sua funcionalidade.) + +Chris: “Dessa forma, nós podemos contribuir para a ciência aberta ” +(Chris destaca a conexão entre contribuir para o NumPy e promover a ciência aberta.) + +Bob: "Maaas\! O que é que nós realmente deveríamos fazer?" +(Bob não tem certeza de como eles podem começar a contribuir para o NumPy.) + +Alice: "Como o NumPy é uma ferramenta usada em microbiologia, estamos criando as ferramentas que tornam a pesquisa científica mais colaborativa e transparente\! Não é incrível?" + +(Alice enfatiza que aprimorar o NumPy pode ter um impacto positivo na pesquisa científica, especialmente em áreas como a microbiologia.) + +Chris: "Hum… Acho que devemos criar uma issue no GitHub.com, dizendo que temos um problema e sugerindo uma solução..." +(Chris lembra que as contribuições para o NumPy começam com a criação de issues no GitHub para abordar problemas.) + +Bob: "Certo, então eu nunca contribui ou fiz nada até agora, mas aprendi muito naquela palestra sobre ciência aberta no semestre passado\!" +(Bob reflete sobre seu conhecimento em ciência aberta, mas admite que ainda não fez contribuições.) + +Chris: “Eu tenho uma conta no GitHub. Podemos tentar com a minha\!” +(Chris se oferece para usar sua conta do GitHub para começar.) + +Alice: "Ótimo\! Vamos olhar o NumPy.org para encontrar a página deles no GitHub." +(Alice sugere que eles visitem o site do NumPy para localizar o repositório deles no GitHub.) + +**Página 6** + +Alice: “No NumPy.org” +(Alice está navegando pelo site do NumPy) + +Chris: “Vamos clicar aqui\!” +(Chris aponta para a seção no site para explorar mais a fundo.) + +Alice: "Bem, estou olhando o NumPy.org e, hmmm..." +(Alice parece incerta sobre para onde ir a seguir no site.) + +Chris: "Não, tenho quase certeza de que podemos começar com o GitHub. Vamos clicar aqui." +(Chris direciona Alice para visitar o repositório do GitHub do NumPy para começar a contribuir.) + +Bob: "Isso parece complicado. Uma lista de discussão, Slack, chamadas da comunidade? Demais\!" +(Bob se sente sobrecarregado pelas opções de comunidade disponíveis no site do NumPy.) + +Alice: "Aí está\! Agora estamos na página do GitHub do NumPy, com uma lista de problemas." +(Alice chega com sucesso à página do GitHub do NumPy, onde os problemas estão listados.) + +Chris: "Vamos criar uma nova issue aqui. O que queremos é um pedido de recurso." +(Chris explica que eles precisam criar uma nova issue para solicitar um recurso.) + +Alice: "Vamos escrever um problema." +(Alice se prepara para redigir o pedido de recurso.) + +**Página 7** + +Alice: (Escreve) "Mostrar nomes de arquivos no arquivo npz?" +(Alice cria um pedido de recurso sobre a dificuldade em identificar nomes de arquivos dentro de arquivos .npz.) + +Chris: "Oi, somos estudantes de microbiologia usando o NumPy para analisar nossas imagens celulares." +(Chris explica o contexto do seu caso de uso com arquivos .npz.) + +Bob: "Eu não sei como usar keys." +(Bob expressa confusão em relação às keys no estilo dicionário nos objetos do NumPy.) + +Chris: "Ah, sim\! Deixe-me adicionar essa parte..." +(Chris se oferece para ajudar esclarecendo como as chaves funcionam nos objetos do NumPy.) + +**Página 8** + +Bob: "Agora diga a eles para resolverem isso." +(Bob está ansioso por uma solução e quer uma ação imediata.) + +Chris: "Eu não acho que devemos ser tão exigentes\!" +(Chris sugere uma abordagem mais diplomática para o pedido de recurso deles.) + +Alice: (Escreve) "Os nomes dos arquivos poderiam ser mais fáceis de ver? Como logo que você abre um .npz?" +(Alice propõe uma solução potencial para melhorar a interação com arquivos .npz.) + +Bob: "Uhul\! Enviado\! Para internet\!" +(Bob celebra após o envio bem-sucedido do pedido de recurso.) + +**Página 9** + +Chris: "Depois de todo esse trabalho, eu preciso de uma pausa." + +Bob: "Mas e a nossa tarefa?\!" + +Chris: "Ainda podemos usar o NumPy, só que é... inconveniente." + +Chris: "Bem, eu tenho as notificações do GitHub ativadas. Então não se preocupe, vamos receber uma resposta." + +\[O tempo passa, ambos estão relaxando.\] + +Bob: "Oh, alguém respondeu\!\!" + +\[Eles correm animadamente para verificar a resposta.\] + +Chris: "Ahhh, tá bom\! Vamos dar uma olhada." + +**Página 10** + +\[Olhando para a issue no GitHub feita para mostrar nomes de arquivos em arquivos npz\] + +Alice: "Então, esta é a issue que criamos..." + +Alice: "Uau, um mantenedor comentou, e outra pessoa....?" + +Bob: "Quem são essas pessoas?" + +Bob: “O que estão dizendo ?” + +Bob: "Precisamos fazer algo agora?\!" + +\[Alice explica quem é um mantenedor e um contribuinte, a imagem explica como a discussão e a contribuição acontecem\] + +Alice: "A primeira pessoa é um mantenedor." + +Alice: "O mantenedor lidera o NumPy, coordenando com muitas pessoas em direção ao grande objetivo." + +Alice: "A segunda pessoa é um contribuinte." + +Alice: "Eles querem ajudar\! Para resolver nossa issue fazendo um pull request\!" + +Alice: "Juntos, mantenedores e contribuidores implementam novos recursos, corrigem bugs e escrevem documentação para melhorar o NumPy." + +**Página 11** + +Bob: "O contribuinte fez um pull request\! O que é isso?" + +Alice: "Um pull request é um pedido para fazer alterações no código do NumPy. Este está mudando os arquivos npz." + +\[Há um comentário no pull request de um contribuinte dizendo que eles podem ajudar, fornecendo uma solução de como isso pode ser corrigido, levantando um pull request.\] + +Alice: "Podemos ver as mudanças que o contribuinte fez no código." + +Bob: "Para ser honesto, eu não entendo completamente o que está sendo mudado..." + +\[Alice aponta para o resumo do pull request levantado pelo contribuinte, indicando quais alterações de código estão sendo feitas.\] + +Alice: "Tudo bem, aqui está um resumo do que foi alterado." + +\[Bob dá uma olhada no pull request.\] + +Bob: "Eu me pergunto o que o contribuinte está fazendo..." + +Bob: "Eles devem saber tudo sobre o NumPy para fazer um pull request assim..." + +**Página 12** + +\[Na parte seguinte, vemos a perspectiva do contribuinte pensando\] + +"Enquanto isso, muito longe, o criador daquele pull request pensa..." + +Contribuinte: "Ah, eu não sei nada sobre o NumPy?" + +Contribuinte: "Espera \- não se critique tanto. Você sabe sobre o NumPy." + +\[Contribuinte olhando para seu pull request sendo revisado com sucesso\] + +Contribuinte: "Estou feliz que um mantenedor revisou meu trabalho. Mas como eu respondo?" + +Contribuinte: "A revisão disse que eu perdi o X. O que faz sentido." + +Contribuinte: "A maior parte do meu pull request já funciona. Então estou 80% feito." + +Contribuinte: "Só preciso reescrever algumas partes e terminar os últimos 20%\!" + +\[Um contribuinte reflete um pouco sobre sua contribuição e verifica a revisão que recebeu do mantenedor. O contribuinte percebe que ainda há 20% de trabalho a ser concluído.\] + +**Página 13** + +\[Em algum lugar no laboratório, o contribuinte pensa sobre a experiência passada com a questão do arquivo npz\] + +Contribuinte: "Esses estudantes... sinto uma conexão. Faz anos que estive em um laboratório." + +Contribuinte: "Mas me lembro de ter trabalhado no mesmo problema com o tipo de arquivo npz." + +Contribuinte: "Por que eu não submeti minha própria issue? Dizer que precisava dessa ajuda também?" + +Contribuinte: "Acabei criando minhas próprias soluções alternativas." + +Contribuinte: "Se eu tivesse submetido minhas próprias soluções como um pull request todos aqueles anos atrás..." + +Contribuinte: "Talvez eu pudesse ter ajudado outros enfrentando o mesmo problema?" + +Contribuinte: "Eh\! Eu provavelmente estava focado demais em terminar minha tese para submeter um pull request." + +Contribuinte: "Estou feliz por poder retribuir agora." + +Contribuinte: "Me pergunto como o mantenedor está indo." + +Contribuinte: "Ele deve saber tudo sobre o NumPy... muito mais do que eu." + +\[O contribuinte reflete sobre o passado, quando enfrentou um problema com o tipo de arquivo npz e pensa que uma issue poderia ter sido levantada antes.\] + +**Página 14** + +"Enquanto isso, muito longe, o mantenedor do NumPy pensa..." + +Mantenedor: \[Bebendo um café\] "Posso ver que quem fez o PR atualizou seu pull request com base nos meus comentários." + +Mantenedor: "Vou revisar o código novamente e verificar se está pronto para ser mesclado." + +\[O mantenedor dá uma olhada nas mudanças revisadas e margeia o pull request.\] + +Mantenedor: "Estou feliz por ter esses estudantes me informando sobre os problemas que estão enfrentando." + +Mantenedor: "Não sou mais professor em laboratório há um ano, então não estou sempre ciente desses problemas." + +Mantenedor: "Estou contente que futuros estudantes poderão navegar mais facilmente com arquivos npz." + +\["O mantenedor revisa o pull request e se sente grato pelos estudantes que levantaram a questão sobre o problema que estão enfrentando."\] + +**Pagina 15** + +"2 meses depois" + +Alice: "Confira este e-mail\!" + +\[Todos os três verificam o e-mail que receberam, já que se inscreveram na lista de discussão do NumPy.\] + +"É da lista de discussão do NumPy. Eu me inscrevi para acompanhar nossa issue." + +Alice: "Agora nosso recurso solicitado está aqui, neste ciclo de lançamento + +\[Um vislumbre do e-mail mostrando os recursos no lançamento.\] + +Chris: "Isso soa legal... será que realmente funciona?" + +\[Eles agora testam o código de exemplo para carregar o arquivo npz e verificar se o novo recurso foi atualizado ou não, e funciona\!\!\!\!\!\!\!\] + +\[Todos, chocados e animados\]: "Uau\! É muito mais fácil ver se as imagens celulares vieram do laboratório das 10h ou das 14h." + +**Página 16** + +Chris: "Uau. Agora eu entendo." + +Chris: "É tão legal saber que eu fiz a diferença para o NumPy\!" + +\[Chris conta a história sobre como essas mudanças começaram com uma única issue.\] + +\[O estudante escreve uma issue, o contribuinte escreve um pull request, o mantenedor revisa o pull request, o pull request é mesclado e o código adicionado ao código base do NumPy, a versão atualizada do NumPy é lançada em todo o mundo.\] + +Chris: "Começou com uma pessoa e cresceu a partir daí\! O problema do arquivo npz e o NumPy foram construídos por muitas pessoas, todos colaborando e se apoiando." + +\[A animação continua.\] + +"Agora eu quero participar da próxima chamada da comunidade do NumPy." + +"Eu quero entender o código base do NumPy também." + +"Eu também quero fazer meu próprio pull request." + +"Conhecer esses contribuintes que nos ajudaram." + +"Desmontá-lo, fazer perguntas." + +"Uau, eles mudaram de serem os maiores céticos para os maiores fãs do NumPy\!" + +"Vai em frente\!" + +"O Fim." \ No newline at end of file