Recentemente, introduzimos um novo parágrafo na versão de desenvolvimento do nosso guia dev
Forneça uma maneira de as pessoas usuárias optarem por não usar a verbosidade, preferencialmente no nível do pacote: torne a criação de mensagens dependente de uma variável ou opção de ambiente (como “usethis.quiet” no pacote usethis), em vez de um parâmetro de função. O controle das mensagens pode ser feito em vários níveis (“nenhum”, “informar”, “depurar”) em vez de ser lógico (nenhuma mensagem / todas as mensagens). O controle da verbosidade é útil para usuários(as) finais, mas também em testes. Você pode encontrar comentários mais interessantes em um artigo do edição do guia de design do tidyverse.
...
“Sou apenas um cientista político, em pé diante do console do R, pedindo que me ajude a terminar uma tese.”
Corria o ano de 2015, um estudante de mestrado em Ciência Política precisava processar dados para entregar sua tese e decidiu aproveitar a oportunidade para aprender a usar R. Ao longo e tortuoso caminho do requisito acadêmico, foi adicionada uma dificuldade extra: incorporar um software de programação desde o início, com uma curva de aprendizado um tanto íngreme.
...Dicas sobre como criar e divulgar issues de “procura-se ajuda” (help wanted).
Uma tentativa de definir o que significa a manutenção de pacotes, com algumas dicas.
Os desafios encontrados pelas pessoas editoras e as medidas que tomamos para tentar aliviar esses problemas.