Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions booknews.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

## dev version

- 2025-12-15, remove codemeta.json requirement (#968).

- 2025-10-17, clarify the use of Rd tags for internal functions (#918, `@cforgaci`).

- 2025-10-09, add translation of the last chapter to Portuguese!
Expand Down
2 changes: 1 addition & 1 deletion maintenance_github_grooming.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ rOpenSci packages are currently in their vast majority developed on GitHub. Here

### GitHub repo topics {#git-hub-repo-topics}

GitHub [repo topics](https://blog.github.com/2017-01-31-introducing-topics/) help browsing and searching GitHub repos, are used by [R-universe on package pages and for search results](https://docs.r-universe.dev/publish/metadata.html#keywords), and are digested by [`codemetar`](https://github.com/ropensci/codemetar) for rOpenSci registry keywords.
GitHub [repo topics](https://blog.github.com/2017-01-31-introducing-topics/) help browsing and searching GitHub repos, are used by [R-universe on package pages and for search results](https://docs.r-universe.dev/publish/metadata.html#keywords).

We recommend:

Expand Down
2 changes: 1 addition & 1 deletion maintenance_github_grooming.es.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Aquí tienes algunos consejos para aprovechar la plataforma en una sección sobr

### Áreas de repositorio en GitHub {#git-hub-repo-topics}

Las [áreas del repositorio](https://blog.github.com/2017-01-31-introducing-topics/) de GitHub ayudan a navegar y buscar en los repositorios de GitHub, son usadas por [R-universe en paginas de paquetes y para resultados de busquedas](https://docs.r-universe.dev/publish/metadata.html#keywords). También son usadas por [`codemetar`](https://github.com/ropensci/codemetar) en las palabras clave del registro de rOpenSci.
Las [áreas del repositorio](https://blog.github.com/2017-01-31-introducing-topics/) de GitHub ayudan a navegar y buscar en los repositorios de GitHub, son usadas por [R-universe en paginas de paquetes y para resultados de busquedas](https://docs.r-universe.dev/publish/metadata.html#keywords).

Recomendamos:

Expand Down
2 changes: 1 addition & 1 deletion maintenance_github_grooming.pt.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Atualmente, os pacotes da rOpenSci são, em sua grande maioria, desenvolvidos no

### Áreas de repositório do GitHub {#git-hub-repo-topics}

As [áreas de repositório](https://blog.github.com/2017-01-31-introducing-topics/) do GitHub ajudam a navegar e pesquisar repositórios do GitHub, são usadas pelo [R-universe em páginas de pacotes e para resultados de pesquisa](https://docs.r-universe.dev/publish/metadata.html#keywords). Também são processadas pelo [`codemetar`](https://github.com/ropensci/codemetar) nas palavras-chave de registro da rOpenSci.
As [áreas de repositório](https://blog.github.com/2017-01-31-introducing-topics/) do GitHub ajudam a navegar e pesquisar repositórios do GitHub, são usadas pelo [R-universe em páginas de pacotes e para resultados de pesquisa](https://docs.r-universe.dev/publish/metadata.html#keywords).

Recomendamos:

Expand Down
3 changes: 0 additions & 3 deletions pkg_building.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,6 @@ We recommend that package developers read Hadley Wickham and Jenny Bryan's thoro

- Find other interesting aspects of naming your package [in this blog post by Nick Tierney](https://www.njtierney.com/post/2018/06/20/naming-things/), and in case you change your mind, find out [how to rename your package in this other blog post of Nick's](https://www.njtierney.com/post/2017/10/27/change-pkg-name/).

### Creating metadata for your package {#creating-metadata-for-your-package}

We recommend you to use the [`codemetar` package](https://github.com/ropensci/codemetar) for creating and updating a JSON [CodeMeta](https://codemeta.github.io/) metadata file for your package via `codemetar::write_codemeta()`. It will automatically include all useful information, including [GitHub topics](#grooming). CodeMeta uses [Schema.org terms](https://schema.org/) so as it gains popularity the JSON metadata of your package might be used by third-party services, maybe even search engines.

## Platforms {#platforms}

Expand Down
6 changes: 0 additions & 6 deletions pkg_building.es.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,6 @@ Para leer por qué vale la pena enviar un paquete a rOpenSci siguiendo las recom
- [Este artículo de Nick Tierney (en inglés)](https://www.njtierney.com/post/2018/06/20/naming-things/) lista otras consideraciones interesantes a tener en cuenta al nombrar paquetes de R.
En caso de que cambies de opinión sobre el nombre de tu paquete, este segundo artículo de Nick explica [cómo cambiar el nombre de tu paquete](https://www.njtierney.com/post/2017/10/27/change-pkg-name/).

### Crear metadatos para tu paquete {#creating-metadata-for-your-package}

Recomendamos usar el [paquete `codemetar`](https://github.com/ropensci/codemetar) para crear y actualizar un archivo JSON [CodeMeta](https://codemeta.github.io/) para tu paquete usando `codemetar::write_codemeta()`.
Incluirá automáticamente toda la información útil, incluyendo [temas de GitHub](#grooming).
CodeMeta utiliza [términos de Schema.org](https://schema.org/) por lo que, a medida que gane popularidad, los metadatos JSON de tu paquete podrían ser utilizados por servicios de terceros, incluso por motores de búsqueda.

## Plataformas {#platforms}

- Los paquetes deben funcionar en todas las plataformas principales (Windows, macOS, Linux). Puede haber excepciones para paquetes que interactúen con funciones específicas del sistema, o que adapten utilidades que sólo funcionan en plataformas limitadas, pero se debe hacer todo lo posible para garantizar la compatibilidad entre plataformas, incluyendo la compilación específica en cada sistema, o la contenerización de utilidades externas.
Expand Down
4 changes: 0 additions & 4 deletions pkg_building.pt.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -27,10 +27,6 @@ Recomendamos que as pessoas desenvolvedoras de pacotes leiam o livro completo de

- Encontre outros aspectos interessantes sobre como nomear seu pacote [neste texto do blog do Nick Tierney (em inglês)](https://www.njtierney.com/post/2018/06/20/naming-things/) e, caso você mude de ideia, descubra [como renomear seu pacote nesta outra postagem do blog do Nick](https://www.njtierney.com/post/2017/10/27/change-pkg-name/).

### Criando metadados para seu pacote {#creating-metadata-for-your-package}

Recomendamos que você use o [pacote `codemetar`](https://github.com/ropensci/codemetar) para criar e atualizar um arquivo JSON [CodeMeta](https://codemeta.github.io/) para seu pacote por meio de `codemetar::write_codemeta()`. Ele incluirá automaticamente todas as informações úteis, incluindo [tópicos do GitHub](#grooming). O CodeMeta usa [termos do Schema.org](https://schema.org/), portanto, à medida que ganha popularidade, os metadados JSON do seu pacote podem ser usados por serviços de terceiros, talvez até por mecanismos de pesquisa.

## Plataformas {#platforms}

- Os pacotes devem funcionar em todas as principais plataformas (Windows, macOS, Linux). Pode haver exceções para pacotes que interajam com funções específicas do sistema ou que adaptem utilitários que só funcionam em plataformas limitadas, mas deve-se fazer todo o possível para garantir a compatibilidade entre plataformas, incluindo a compilação específica em cada sistema ou a containerização de utilitários externos.
Expand Down
Loading