R Dev Day

R Dev Day @ LatinR 2024

Datas: 18 e 19 de novembro de 2024, das 17h30 às 20h (UTC-3)

Modalidade: Online

Inscrição: https://pretix.eu/r-contributors/r-dev-day-latinr2024/

Idiomas: Inglês, português e espanhol

Sobre

O R Dev Day @ LatinR 2024 é um evento colaborativo no qual as pessoas participantes trabalharão em pequenos grupos para contribuir para o R base ou para a infraestrutura que dá suporte a essas contribuições, por exemplo:

  • Traduzir textos de mensagens para espanhol/português brasileiro
  • Propor melhorias nos arquivos de ajuda do R (conteúdo que acessamos no help ou ? no R)
  • Analisar um erro relatado no R
  • Desenvolver uma correção para um erro relatado no R
  • Adicionar conteúdo ao R Dev Guide, o guia de contribuição ao R base
  • Melhorar o R Translations Dashboard, o painel utilizado para acompanhar o andamento das traduções

Tanto pessoas colaboradoras novas quanto experientes estão convidadas a participar!

Quando

Haverá duas sessões na segunda-feira, 18 de novembro, e na terça-feira, 19 de novembro. No mesmo horário todos os dias:

UTC Buenos Aires e Brasília (UTC-3) Hermosillo (UTC-7)
8:30pm - 11pm 5:30pm - 8pm 1:30pm - 4pm

Recomendamos que você participe de ambas as sessões, se possível, mas não há problema em participar de apenas uma sessão.

Comunicação

Haverá uma breve introdução (~10 minutos) no início de cada sessão em inglês, espanhol e português.

Usaremos o canal “r-dev-day” no Slack da LatinR para discussões relacionadas - o uso de inglês, espanhol ou português é bem-vindo.

Os grupos menores podem acordar um idioma comum para trabalhar - o inglês será o padrão, mas as pessoas facilitadoras que falam espanhol e português estarão disponíveis para ajudar.

Tarefas

As tarefas serão preparadas como issues neste repositório com o rótulo LatinR2024. Você pode adicionar issues ou discutir ideias para issues, conforme descrito no README.

As issues estão resumidos na planilha do R Dev Day @ LatinR 2024 Working Group Allocations. Adicione seu nome à lista de pessoas colaboradoras se tiver interesse em trabalhar em uma issue. Você pode se incluir em várias issues, pois não se trata de um compromisso final - as alocações serão finalizadas no início de cada sessão.

Fique de olho nas edições antes do evento. Talvez você precise de preparação adicional para trabalhar em determinadas questões, por exemplo, aprender a fazer o build do R no macOS ou ler um material de apoio.

Configuração do desenvolvimento

A maioria das pessoas poderá trabalhar somente pelo navegador (usando o Weblate, a interface do navegador do GitHub, o GitHub Codespaces ou o Gitpod). O trabalho com bugs específicos do sistema operacional pode exigir fazer o build do R no seu próprio computador.

Preparação

Algumas coisas que você pode fazer para ajudar a se preparar, se tiver tempo:

  • Solicite uma conta no Bugzilla do R se você quiser trabalhar em bugs no código/documentação e ainda não tiver uma conta. O processo pode levar alguns dias, mas é apenas um “é bom ter”.
  • Crie uma conta no Weblate se você quiser trabalhar com traduções. Isso também pode ser feito durante o evento.
  • Se quiser trabalhar em bugs no código do R (em comparação com a documentação, o R Translations Dashboard ou o R Dev Guide) e não se sentir confortável com fazer o build do R a partir do código-fonte, recomendamos que aprenda a usar o R Dev Container, conforme descrito na seção Outros recursos (leva aproximadamente 1 hora). Isso não será necessário para todas as tarefas que envolvem código, mas abrirá mais possibilidades.

A seção Outros recursos contém links para aprender mais sobre como contribuir. Trabalhar com esses links com antecedência é totalmente opcional - nosso objetivo é adequar você às tarefas de acordo com seu conhecimento e experiência atuais - mas eles o ajudarão a se envolver no evento.

Se tiver alguma dúvida, sinta-se à vontade para entrar em contato com um dos membros do comitê organizador por meio do Slack do LatinR:

Falantes de espanhol Falantes de português Falantes de inglês
Pao Corrales Beatriz Milz gwynn gebeyhu
Macarena Quiroga Heather Turner
Patricia Loto
Andrea Gomez Vargas
Luis Darcy Verde Arregoitia
Ricardo Villalba

Outros recursos

Reviewing Bug Reports, postagem do blog do R (leitura de 3 minutos)

Debugging in R (1h45 de vídeo)

Analysing Bugs/Contributing Patches(2h15 de vídeo + exercícios - pressupõe algum conhecimento de depuração em R).

Starting Workspace e Stopping and restarting, para aprender a usar o R Dev Container por meio do navegador com espaços de trabalho do Gitpod, seguido por Running R, Building R e R Contribution Workflow para aprender os fundamentos do uso do R Dev Container para desenvolver alterações no R básico (guia passo a passo de <1 hora).

R Dev Guide (ebook). Foi criado como uma referência para pessoas colaboradoras sobre diferentes aspectos da contribuição para o R. Em particular, consulte o Capítulo 2 para saber como fazer o build do R no seu próprio computador. Atualmente, as instruções para macOS não foram incorporadas, mas há uma versão preliminar.

Contributing translations to R (1h de vídeo), tutorial que apresenta a tradução por meio da interface do navegador Weblate.