diff --git a/maintenance_curation.pt.Rmd b/maintenance_curation.pt.Rmd index 3b42c9763..6027648bc 100644 --- a/maintenance_curation.pt.Rmd +++ b/maintenance_curation.pt.Rmd @@ -6,18 +6,18 @@ aliases: # Política de curadoria de pacotes {#curationpolicy} ```{block, type="summaryblock"} -Este capítulo resume uma proposta de política de curadoria para a manutenção contínua de pacotes -manutenção contínua de pacotes desenvolvidos como parte das atividades do rOpenSci -e/ou sob a organização do rOpenSci no GitHub. Essa política de curadoria visa -apoiar esses objetivos: +Este capítulo resume uma proposta de política de curadoria para a manutenção contínua de +pacotes desenvolvidos como parte das atividades da rOpenSci +e/ou sob a organização da rOpenSci no GitHub. Essa política de curadoria visa +apoiar os seguintes objetivos: - Garantir que os pacotes fornecidos pela rOpenSci estejam atualizados e sejam de alta qualidade - Fornecer clareza quanto ao status de desenvolvimento e revisão - de qualquer software nos repositórios do rOpenSci + de qualquer software nos repositórios da rOpenSci -- Gerenciar o esforço de manutenção para a equipe do rOpenSci, autores de pacotes e - colaboradores voluntários +- Gerenciar o esforço de manutenção para a equipe da rOpenSci, para os(as) autores(as) de pacotes e + para os(as) colaboradores(as) voluntários(as) - Fornecer um mecanismo para que os pacotes sejam descontinuados de forma adequada, mantendo o selo de revisão por pares @@ -25,194 +25,196 @@ apoiar esses objetivos: ``` Elementos de infraestrutura descritos -abaixo necessários para a implementação da política são, em alguns casos, parcialmente -parcialmente construídos e, em outros casos, ainda não foram iniciados. Nosso objetivo é adotar essa política em +abaixo necessários para a implementação da política foram, em alguns casos, parcialmente +construídos e, em outros casos, ainda não foram iniciados. Nosso objetivo é adotar essa política em parte para priorizar o trabalho nesses componentes. ## O registro de pacotes {#the-package-registry} - O pacote rOpenSci - [registro](https://github.com/ropensci/roregistry) - é uma listagem central dos pacotes R que você já usou ou usou. - Ele contém pacotes essenciais que você pode usar para criar um pacote R. - essenciais, incluindo o status de desenvolvimento e revisão, e será o - e será a fonte de dados para exibição em sites, crachás, etc. Ele permitirá que você - que essa listagem seja mantida independentemente do pacote ou do + [registry](https://github.com/ropensci/roregistry) + é uma lista centralizada dos pacotes R que são mantidos atualmente (ou que foram + mantidos anteriormente) pela rOpenSci. + Ele contém metadados essenciais sobre os pacotes, incluindo o status de desenvolvimento e de revisão, + e será a fonte de dados para exibição em sites, *badges*, etc. Ele permite + que essa lista seja mantida de forma independente do pacote ou das plataformas de hospedagem de infraestrutura. ## Pacotes mantidos pela equipe {#staff-maintained-packages} -Os pacotes mantidos pela equipe são desenvolvidos e mantidos pela equipe da rOpenSci -como parte dos projetos rOpenSci. Esses pacotes também podem ser revisados por pares -mas não são necessariamente revisados por pares. Muitos são de infraestrutura -que estão fora do escopo da revisão por pares. +Os pacotes mantidos pela equipe são pacotes desenvolvidos e mantidos pela equipe da rOpenSci +como parte dos projetos internos da rOpenSci. Esses pacotes também podem ser revisados por pares +mas não são necessariamente revisados por pares. Muitos desses pacotes +estão fora do escopo da revisão por pares. - Os pacotes mantidos pela equipe serão listados no registro com a tag - "staff\_maintained" e listados na página da Web de pacotes da rOpenSci ou similar - locais com a tag "staff-maintained" (mantido pela equipe) + "staff\_maintained" e listados na página da Web de pacotes da rOpenSci, ou em locais similares + com a tag "staff-maintained" (mantido pela equipe) -- Esses pacotes serão armazenados no GitHub "ropensci" - organização +- Esses pacotes serão armazenados no dentro da organização no GitHub + chamada "ropensci" + -- Os pacotes mantidos pela equipe e seus documentos serão criados pela rOpenSci - [sistema](https://status.ropensci.org/). Esse sistema não envia notificações - mas gera resultados como status de commit do GitHub (marca de seleção vermelha ou cruz vermelha). +- Os pacotes mantidos pela equipe e seus documentos serão criados pelo [sistema](https://status.ropensci.org/) + da rOpenSci. Esse sistema não envia notificações, + mas gera resultados como status de commit do GitHub (o *red check mark* ou o *red cross*). - Quando os pacotes falham nas verificações, a equipe da rOpenSci se esforça para corrigir - alterações, priorizando os pacotes com base na base de usuários (downloads), - dependências reversas ou objetivos estratégicos. + as alterações, priorizando os pacotes com base no volume de usuários (isto é, o volume de *downloads*), de + dependências reversas ou de objetivos estratégicos. - Em uma base semestral ou anual, a rOpenSci analisará todos os pacotes - que estão falhando há mais de um mês para determinar se você deve transferi-los para o [ organização "ropensci-archive" do GitHub](https://github.com/ropensci-archive). + que estão falhando há mais de um mês para determinar se você deve + transferi-los para a [organização "ropensci-archive" no GitHub](https://github.com/ropensci-archive). - Pacotes que falham consistentemente e sem um plano contínuo para retornar - para manutenção ativa passarão para o status de "arquivo". Quando + para uma manutenção ativa, vão passar para o status de "archive". Quando arquivados, os pacotes da equipe serão movidos para o diretório "ropensci-archive" - (a ser criado) e ganharão o tipo "archived" em - no registro. Eles não serão criados no sistema rOpenSci. + (a ser criado) e ganharão o tipo "archived" + no registro. Eles não serão construídos no sistema da rOpenSci. -- Os pacotes arquivados não serão exibidos por padrão na seção de pacotes - página da Web. Uma guia especial das páginas de pacotes exibirá - esses pacotes com `"type": "archived"` - que foram revisados por pares ou mantidos pela equipe. +- Os pacotes arquivados não serão exibidos por padrão na seção de pacotes da + página da Web. Esses pacotes serão exibidos em uma guia especial das páginas de pacotes + com `"type": "archived"` + que foram revisados por pares ou que foram mantidos pela equipe. - Os pacotes arquivados podem ser desarquivados quando o mantenedor antigo ou um novo mantenedor estiver disposto a resolver os problemas e quiser reviver o pacote. - pacote. Para isso, você deve [entre em contato com a rOpenSci](https://ropensci.org/contact/). - Eles são transferidos para a organização ropenscilabs. + Para isso, você deve [entrar em contato com a rOpenSci](https://ropensci.org/contact/). + Esses pacotes serão transferidos para a organização ropenscilabs. ## Pacotes revisados por pares {#peer-reviewed-packages} -Os pacotes revisados por pares são aqueles contribuídos para o rOpenSci pelo -pela comunidade e que passaram pela revisão por pares. Eles precisam ser -[dentro do escopo](#aims-and-scope) -no momento do envio a ser revisado. +Os pacotes revisados por pares são aqueles contribuídos para a rOpenSci +pela comunidade e que passaram pela revisão por pares. Eles precisam estar +[dentro do escopo](#aims-and-scope) no momento em que eles são enviados para serem revisados. -- Após a aceitação, esses pacotes revisados por pares são transferidos de - do GitHub do autor para a organização "ropensci" do GitHub +- Após a aceitação, esses pacotes revisados por pares são transferidos + do GitHub do(a) autor(a) para dentro da organização "ropensci" no GitHub -- Os pacotes revisados por pares estarão no registro marcados como - "peer-reviewed" e terão um selo de revisão por pares em seu README. +- Os pacotes revisados por pares estarão marcados no registro como + "peer-reviewed", e terão um selo de revisão por pares em seu README. -- Os pacotes revisados por pares serão listados na página da Web do rOpenSci ou - locais semelhantes com a tag "peer-reviewed" (revisado por pares) +- Os pacotes revisados por pares serão listados na página da Web da rOpenSci, ou + em locais semelhantes, com a tag "peer-reviewed" (revisado por pares) -- Os pacotes revisados por pares e seus documentos serão construídos pela rOpenSci - [sistema](https://status.ropensci.org/). Esse sistema não envia notificações - mas gera resultados como status de commit do GitHub (marca de seleção vermelha ou cruz vermelha). +- Os pacotes revisados por pares e seus documentos serão construídos pelo + [sistema](https://status.ropensci.org/) da rOpenSci. Esse sistema não envia notificações + mas gera resultados como o status de commit do GitHub (o *red check mark* ou o *red cross*). -- Anualmente ou semestralmente, a equipe da rOpenSci revisará os pacotes em um - estado de falha ou que estejam falhando por longos períodos, e - entrará em contato com os autores para determinar o status da manutenção em andamento e +- Anualmente ou semestralmente, a equipe da rOpenSci revisará os pacotes que estão em + estado de falha ou que estão falhando já por longos períodos, e + entrará em contato com os autores para determinar o status da manutenção e das atualizações esperadas. Com base nesse intercâmbio, a rOpenSci pode optar por manter o status atual do pacote com a expectativa de uma - atualizações, contribuir com suporte ou buscar um novo mantenedor, ou transferir - o pacote para o status "arquivado". - -- Com base na base de usuários (medida por downloads), dependências reversas ou - objetivos estratégicos da rOpenSci, a equipe da rOpenSci pode apoiar a falha de - pacotes com problemas por meio de PRs revisados pelos autores dos pacotes ou alterações diretas - (se os autores não responderem por aproximadamente um mês). rOpenSci - também fornecerá suporte aos autores de pacotes mediante solicitação, tanto por - equipe e voluntários da comunidade, de acordo com o tempo disponível. - -- A pedido do autor, ou se os autores não responderem a - não responderem às consultas por aproximadamente um mês, a rOpenSci poderá procurar um novo - mantenedor para pacotes selecionados, revisados por pares, que ele considere ter alta - valor para a comunidade, com base na base de usuários/downloads, reverter - dependências reversas ou objetivos estratégicos da rOpenSci. - -- Quando arquivados, esses pacotes serão movidos do GitHub "ropensci - para a organização "ropensci-archive" (ou autor - contas do GitHub do autor, se você desejar), seguindo [orientação de transferência](#archivalguidance). Elas ganharão o tipo "arquivado" - no registro. Eles manterão as tags "peer-reviewed" (revisado por pares) e - e emblemas. Eles não serão criados no sistema rOpenSci. - -- Os pacotes arquivados não serão exibidos por padrão. Uma guia especial de pacotes - exibirá esses pacotes com `"type": "archived"` - que foram revisados por pares ou mantidos pela equipe. - -## Pacotes adquiridos legados {#legacy-acquired-packages} - - Os pacotes "legados" são pacotes que não foram criados ou mantidos pela rOpenSci -e não são revisados por pares, mas estão sob o rOpenSci GitHub -devido a razões históricas. (Antes de estabelecer a organização -processo de revisão por pares e seu escopo, a rOpenSci absorveu pacotes de + atualização, ou contribuir com algum suporte, ou ainda, buscar um novo mantenedor, ou transferir + o pacote para o status "archived". + +- Com base no volume de usuários (isto é, o volume de *downloads* do pacote), ou das dependências reversas, ou + dos objetivos estratégicos da rOpenSci, a equipe da rOpenSci pode apoiar os + pacotes que estiverem com problemas e falhas, por meio de PRs que são revisados pelos autores dos pacotes, + ou ainda, com alterações diretas + (se os autores não responderem por aproximadamente um mês). A rOpenSci + também fornecerá suporte aos autores de pacotes mediante solicitação, tanto pela + equipe interna, quanto por voluntários da comunidade, de acordo com o tempo disponível. + +- A pedido do autor, ou se os autores não responderem às consultas por aproximadamente um mês, + a rOpenSci poderá procurar um novo + mantenedor para os pacotes selecionados, que sejam revisados por pares, e que a rOpenSci considere ter alta + valor para a comunidade, com base no volume de usuários/*downloads*, ou nas + dependências reversas, ou nos objetivos estratégicos da rOpenSci. + +- Quando arquivados, esses pacotes serão movidos da organização "ropensci" + para a organização "ropensci-archive" no GitHub (ou para a conta do autor + no GitHub, caso for de desejo do autor), seguindo as [orientações de transferência](#archivalguidance). + Elas ganharão o tipo "archived" + no registro. Esses pacotes vão manter as tags "peer-reviewed" (revisado por pares) e + e *badges*. Eles não serão construídos no sistema da rOpenSci. + +- Os pacotes arquivados não serão exibidos por padrão na seção de pacotes da + página da Web. Esses pacotes serão exibidos em uma guia especial das páginas de pacotes + com `"type": "archived"` que foram revisados por pares, ou que foram mantidos pela equipe. + +## Pacotes legado que foram adquiridos {#legacy-acquired-packages} + +Os pacotes "legado" são pacotes que não foram criados ou mantidos pela rOpenSci +e que também não são revisados por pares, mas que estão sob o controle da rOpenSci no GitHub +devido a razões históricas. (Antes de estabelecer a organização, e o seu +processo de revisão por pares e o seu escopo, a rOpenSci absorveu pacotes de vários desenvolvedores sem critérios bem definidos). -- A rOpenSci transferirá os pacotes legados de volta para as organizações autoras - e repositórios. Se os autores não tiverem interesse, transferiremos - para o repositório "ropensci-archive", seguindo os passos abaixo [orientação de transferência](#archivalguidance). Se os pacotes forem +- A rOpenSci transferirá os pacotes legado de volta para as organizações + e repositórios dos autores. Se os autores não tiverem interesse, transferiremos + para o repositório "ropensci-archive", seguindo as regras das [orientações de transferência](#archivalguidance). Se os pacotes estiverem [no escopo](https://devguide.ropensci.org/policies.html#aims-and-scope), - rOpenSci perguntará se os autores gostariam de submetê-los à + a rOpenSci perguntará se os autores gostariam de submetê-los ao processo de revisão de software. -- Os pacotes legados não serão listados no registro de pacotes. +- Os pacotes legado não serão listados no registro de pacotes. -- Exceções podem ser feitas para pacotes que sejam partes vitais do ecossistema de pacotes do R e/ou do rOpenSci e que sejam ativamente monitorados pela equipe. +- Exceções podem ser feitas para pacotes que sejam partes vitais do ecossistema de pacotes do R e/ou da rOpenSci, e que sejam ativamente monitorados pela equipe. ## Pacotes de incubadora {#incubator-packages} - Os pacotes "Incubadora" são pacotes em desenvolvimento criados pela equipe ou por +Os pacotes de "incubadora" são pacotes em desenvolvimento criados pela equipe ou por membros da comunidade como parte de projetos comunitários, como os criados por -em não conferências +em desconferências. -- Os pacotes da incubadora ficarão na organização "ropenscilabs". +- Os pacotes de incubadora ficarão na organização "ropenscilabs" no GitHub. -- Os pacotes da incubadora aparecerão no registro de pacotes com o símbolo - "tag "incubadora +- Os pacotes de incubadora aparecerão no registro de pacotes com a + tag "incubator". -- Os pacotes da incubadora não serão exibidos no site por padrão, mas você pode usar a tag "Incubator" para fazer isso. - as páginas de pacotes incluirão uma guia "pacotes experimentais". +- Os pacotes de incubadora não serão exibidos no site por padrão, mas + as páginas de pacotes incluem uma guia especial de "pacotes experimentais". -- Os pacotes da incubadora e seus documentos serão criados pelo rOpenSci - [sistema](https://status.ropensci.org/). Esse sistema não envia notificações - mas gera resultados como status de commit do GitHub (marca de seleção vermelha ou cruz vermelha). +- Os pacotes da incubadora e seus documentos serão criados pelo + [sistema](https://status.ropensci.org/) da rOpenSci. Esse sistema não envia notificações + mas gera resultados como o status de commit do GitHub (o *red check mark* ou o *red cross*). Os documentos indicarão claramente que o pacote é experimental. -- Semestralmente ou anualmente, a rOpenSci entrará em contato com os mantenedores da incubadora - sobre repositórios com pelo menos três meses de idade, perguntando sobre - sobre o status de desenvolvimento e as preferências dos autores para migração para o - revisão por pares, ropensci-archive ou para organizações de autores. Baseado em - nas respostas, o pacote será migrado imediatamente, a revisão por pares +- Semestralmente ou anualmente, a rOpenSci entrará em contato com os mantenedores desses pacotes de incubadora + sobre repositórios que tenham pelo menos três meses de idade, perguntando + sobre o status de desenvolvimento e as preferências dos autores sobre uma migração para o + processo de revisão por pares, ou para o "ropensci-archive", ou para uma organização dos autores. Baseado em + nas respostas, o pacote será migrado imediatamente, e a revisão por pares será iniciada, ou a migração será adiada para a próxima - revisão. Os pacotes da incubadora serão migrados para o ropensci-archive até - por padrão, após um ano, depois que você [orientação de transferência](#archivalguidance). + revisão. Os pacotes de incubadora serão migrados para o "ropensci-archive" + por padrão, seguindo as [orientações de transferência](#archivalguidance). -- Os pacotes de incubadoras arquivados ganharão o tipo "arquivado". +- Os pacotes de incubadora arquivados ganharão o tipo "archived". -### Pacotes não-R da incubadora {#incubator-non-r-packages} +### Pacotes de incubadora que não sejam pacotes de R {#incubator-non-r-packages} -- A organização da "incubadora" também incluirá pacotes não-R - projetos. +- A organização da "incubadora" também pode incluir pacotes que não sejam pacotes de R. -- Esses projetos não serão listados no registro nem aparecerão em um site - e não serão criados automaticamente. +- Esses projetos não serão listados no registro, e não vão aparecer no site da rOpenSci, + e também não serão construídos automaticamente. -- A política de migração será a mesma dos pacotes R, com - locais de migração apropriados (por exemplo, ropensci-books) +- A política de migração para esses pacotes será a mesma dos pacotes de R, com + locais de migração apropriados (por exemplo, "ropensci-books") -- Se você for arquivado, os pacotes não-R serão movidos para "ropensci-archive", seguindo [orientação de transferência](#archivalguidance). +- Se um pacote que não for um pacote de R for arquivado, ele será movido para + a organização "ropensci-archive", seguindo as [orientações de transferência](#archivalguidance). ## Livros {#books} -Os livros do rOpenSci são uma documentação longa, geralmente no formato bookdown, -relacionados a pacotes, projetos ou temas do rOpenSci, criados por ambos os autores. -equipe do rOpenSci e por membros da comunidade. +Os livros da rOpenSci são documentações longas, geralmente no formato `bookdown`, e +estão relacionados a pacotes, projetos ou temas da rOpenSci, criados tanto pelos autores de pacotes, quanto pela +equipe da rOpenSci, e também por membros da comunidade. -- Os livros ficarão na organização "ropensci-books" +- Os livros ficarão dentro da organização "ropensci-books" no GitHub. -- Os livros serão hospedados em books.ropensci.org +- Os livros serão hospedados no domínio books.ropensci.org - Os livros podem estar maduros ou em desenvolvimento, mas devem ter um mínimo de - mínimo de esboços/conteúdo antes de serem migrados para "ropensci-books" (por exemplo, você pode usar o nome do livro para fazer uma pesquisa). - de "ropenscilabs"). + esboços/conteúdo antes de serem migrados da organização "ropenscilabs" para + dentro da organização "ropensci-books". - A autoria e o status de desenvolvimento de um livro devem ser claramente - descritos em sua página inicial e no LEIAME. + descritos em sua página inicial e no README. -- O rOpenSci pode fornecer emblemas ou modelos (por exemplo, "Em desenvolvimento," - "Mantido pela comunidade") para os autores usarem nas páginas iniciais dos livros - no futuro +- A rOpenSci pode fornecer *badges* ou modelos (por exemplo, "Em desenvolvimento," + "Mantido pela comunidade") para os autores usarem nas páginas iniciais de seus livros.