Verbosity Portuguese translation #1190
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
24 tasks
Member
Author
|
@fblpalmeira can you review this blog post? |
beatrizmilz
reviewed
Nov 18, 2025
| @@ -0,0 +1,182 @@ | |||
| --- | |||
| title: Por favor, cale a boca! Controle de verbosidade em pacotes | |||
Contributor
There was a problem hiding this comment.
I know It's Francesca who is assigned to review this blogpost, but just a small impression/opinion:
"Cale a boca" is a bit harsh/rude in portuguese 😆
Maybe "fique quieto" (translates to "stay quiet!") is more polite.
Contributor
There was a problem hiding this comment.
Thank you for the observation, @beatrizmilz. I had not seen it yet. I will be more attentive to this kind of thing.
Contributor
There was a problem hiding this comment.
I know you did not review it yet, don't worry!! 😆 The "cale a boca" came from the automatic translation.
fblpalmeira
reviewed
Nov 19, 2025
Contributor
fblpalmeira
left a comment
fblpalmeira
left a comment
There was a problem hiding this comment.
Done @yabellini. @beatrizmilz please, see the comment I left about the title of this text; I would like your opinion.
| @@ -0,0 +1,182 @@ | |||
| --- | |||
| title: Por favor, cale a boca! Controle de verbosidade em pacotes | |||
Contributor
There was a problem hiding this comment.
Suggested change
| title: Por favor, cale a boca! Controle de verbosidade em pacotes | |
| title: Por favor, fique quieto(a)! Controle de verbosidade em pacotes |
| doi: 10.59350/a7t5m-cy325 | ||
| --- | ||
|
|
||
| Recentemente, introduzimos um novo parágrafo na versão de desenvolvimento do nosso guia de desenvolvimento |
Contributor
There was a problem hiding this comment.
Suggested change
| Recentemente, introduzimos um novo parágrafo na versão de desenvolvimento do nosso guia de desenvolvimento | |
| Recentemente, introduzimos um novo parágrafo na versão de desenvolvimento do nosso guia dev |
|
|
||
| Recentemente, introduzimos um novo parágrafo na versão de desenvolvimento do nosso guia de desenvolvimento | ||
|
|
||
| > Forneça uma maneira de os usuários optarem por não usar a verbosidade, de preferência no nível do pacote: torne a criação de mensagens dependente de uma variável ou opção de ambiente (como ["usethis.quiet"](https://usethis.r-lib.org/reference/ui.html?q=usethis.quiet#silencing-output) no pacote usethis), em vez de um parâmetro de função. O controle das mensagens pode ser feito em vários níveis ("none", "inform", "debug") em vez de ser lógico (nenhuma mensagem / todas as mensagens). O controle da verbosidade é útil para usuários 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](https://github.com/tidyverse/design/issues/42). |
Contributor
There was a problem hiding this comment.
Suggested change
| > Forneça uma maneira de os usuários optarem por não usar a verbosidade, de preferência no nível do pacote: torne a criação de mensagens dependente de uma variável ou opção de ambiente (como ["usethis.quiet"](https://usethis.r-lib.org/reference/ui.html?q=usethis.quiet#silencing-output) no pacote usethis), em vez de um parâmetro de função. O controle das mensagens pode ser feito em vários níveis ("none", "inform", "debug") em vez de ser lógico (nenhuma mensagem / todas as mensagens). O controle da verbosidade é útil para usuários 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](https://github.com/tidyverse/design/issues/42). | |
| > 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"](https://usethis.r-lib.org/reference/ui.html?q=usethis.quiet#silencing-output) 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](https://github.com/tidyverse/design/issues/42). |
|
|
||
| Isso complementa o [requisitos de revisão de software estatístico para software bayesiano](https://stats-devguide.ropensci.org/standards.html#output-verbosity). | ||
|
|
||
| O objetivo desta nota técnica é tornar o novo requisito mais alto, demonstrar algumas abordagens para o controle de verbosidade e obter feedback da comunidade! |
Contributor
There was a problem hiding this comment.
Suggested change
| O objetivo desta nota técnica é tornar o novo requisito mais alto, demonstrar algumas abordagens para o controle de verbosidade e obter feedback da comunidade! | |
| O objetivo desta nota técnica é tornar o novo requisito mais alto, demonstrar algumas abordagens para o controle de verbosidade e obter a opinião da comunidade! |
|
|
||
| ### Como implementar o controle de verbosidade em nível de pacote no seu pacote | ||
|
|
||
| Uma opção :sweat\_smile: seria você escrever seu próprio wrapper para mensagens como, |
Contributor
There was a problem hiding this comment.
Suggested change
| Uma opção :sweat\_smile: seria você escrever seu próprio wrapper para mensagens como, | |
| Uma opção :sweat\_smile: seria escrever o seu próprio wrapper para mensagens como, |
|
|
||
| Um pacote que usa pacotes do tipo rlang/cli/withr para emitir e controlar mensagens responderá às opções locais (ou globais) da mesma forma que todos os outros pacotes que usam esse sistema. | ||
| Dessa forma, essas opções se tornam verdadeiramente globais, pois são compartilhadas e compreendidas por vários pacotes. | ||
| Um problema com isso é que os usuários muitas vezes podem querer depurar apenas o seu próprio pacote, deixando todos os outros pacotes quietos. |
Contributor
There was a problem hiding this comment.
Suggested change
| Um problema com isso é que os usuários muitas vezes podem querer depurar apenas o seu próprio pacote, deixando todos os outros pacotes quietos. | |
| Um problema com isso é que as pessoas usuárias muitas vezes podem querer depurar apenas o seu próprio pacote, deixando todos os outros pacotes quietos. |
|
|
||
| ### Estendendo os níveis de verbosidade | ||
|
|
||
| Por fim, demonstraremos brevemente como o controle de verbosidade de dois níveis do rlang/cli "quiet"/"verbose" pode ser estendido para implementar um nível de "depuração" em seu próprio pacote. |
Contributor
There was a problem hiding this comment.
Suggested change
| Por fim, demonstraremos brevemente como o controle de verbosidade de dois níveis do rlang/cli "quiet"/"verbose" pode ser estendido para implementar um nível de "depuração" em seu próprio pacote. | |
| Por fim, demonstraremos brevemente como o controle de verbosidade de dois níveis do rlang/cli, "silencioso"/"verboso", pode ser estendido para implementar um nível de "depuração" em seu próprio pacote. |
| ### Estendendo os níveis de verbosidade | ||
|
|
||
| Por fim, demonstraremos brevemente como o controle de verbosidade de dois níveis do rlang/cli "quiet"/"verbose" pode ser estendido para implementar um nível de "depuração" em seu próprio pacote. | ||
| Novamente, isso requer um manipulador de mensagens personalizado, ligeiramente modificado em relação ao anterior para emitir apenas mensagens de depuração: |
Contributor
There was a problem hiding this comment.
Suggested change
| Novamente, isso requer um manipulador de mensagens personalizado, ligeiramente modificado em relação ao anterior para emitir apenas mensagens de depuração: | |
| Novamente, isso requer um manipulador de mensagens personalizado, ligeiramente modificado em relação ao anterior, para emitir apenas mensagens de depuração: |
| } | ||
| ``` | ||
|
|
||
| Isso permite que você tenha esse comportamento: |
Contributor
There was a problem hiding this comment.
Suggested change
| Isso permite que você tenha esse comportamento: | |
| Isso permite esse comportamento: |
|
|
||
| ## Conclusão | ||
|
|
||
| Nesta nota técnica, explicamos nosso novo requisito de que o controle de verbosidade deve ser feito no pacote e não no nível da função, por meio da definição de uma opção pelos usuários. |
Contributor
There was a problem hiding this comment.
Suggested change
| Nesta nota técnica, explicamos nosso novo requisito de que o controle de verbosidade deve ser feito no pacote e não no nível da função, por meio da definição de uma opção pelos usuários. | |
| Nesta nota técnica, explicamos nosso novo requisito de que o controle de verbosidade deve ser feito no pacote, e não no nível da função, por meio da definição de uma opção pelas pessoas usuárias. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.