{"id":15579128,"url":"https://github.com/jayqi/satrday-roxygen-talk","last_synced_at":"2025-06-28T00:03:01.915Z","repository":{"id":96914915,"uuid":"182899637","full_name":"jayqi/satRday-roxygen-talk","owner":"jayqi","description":"Materials for \"Level Up Your Package's Roxygen Documentation\" Lightning Talk @ satRday Chicago 2019","archived":false,"fork":false,"pushed_at":"2019-04-26T22:50:39.000Z","size":388,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-29T07:44:38.013Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jayqi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-23T01:41:56.000Z","updated_at":"2019-04-26T22:50:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"5a71123b-8c41-41a2-b0e2-5f92acfc53ad","html_url":"https://github.com/jayqi/satRday-roxygen-talk","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jayqi/satRday-roxygen-talk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayqi%2FsatRday-roxygen-talk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayqi%2FsatRday-roxygen-talk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayqi%2FsatRday-roxygen-talk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayqi%2FsatRday-roxygen-talk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jayqi","download_url":"https://codeload.github.com/jayqi/satRday-roxygen-talk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayqi%2FsatRday-roxygen-talk/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262352484,"owners_count":23297680,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-02T19:13:55.847Z","updated_at":"2025-06-28T00:03:01.887Z","avatar_url":"https://github.com/jayqi.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \"Level Up Your Package's Roxygen Documentation\" Talk\n\n[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/) \n\nThis repository contains the materials for \"Level Up Your Package's Roxygen Documentation,\" a lightning talk at the [satRday Chicago 2019](https://chicago2019.satrdays.org) conference. \n\n\u003e The [roxygen2](https://cran.r-project.org/package=roxygen2) package is the standard for writing documentation for R packages. While the basics are intuitive enough to copy from seeing anybody else’s package, roxygen2 has some advanced tricks that aren’t so obvious. This lightning talk will show some of those tricks, including dummy articles, section and parameter inheritance, and package articles.\n\nPresentation: \n\n- [Original Google Slides](https://docs.google.com/presentation/d/13EZXJNnMGhYEzfYvjStb8RG4PYWIfdorCNUcD2Yz5tk/edit?usp=sharing)\n- [PDF version](https://raw.githubusercontent.com/jayqi/satRday-roxygen-talk/master/slides.pdf)\n\n## Demo Package `pokemon`\n\nThe source for the examples from the talk are available in the demo package `pokemon`. To install:\n```R\nremotes::install_github(\"https://github.com/jayqi/satRday-roxygen-talk\", subdir = \"pokemon\")\n```\n\nThen use the `library` function to load the package:\n```R\nlibrary(pokemon)\n```\n\n## Source and Documentation Commands for Examples\n\n- Generic Function Example\n  - Source: [R/parameter_inheritance.R](https://github.com/jayqi/satRday-roxygen-talk/blob/master/pokemon/R/parameter_inheritance.R)\n  - RStudio doc shortcut: `?get_pokemon_by_number`\n- Package Article\n  - Source: [R/package_article.R](https://github.com/jayqi/satRday-roxygen-talk/blob/master/pokemon/R/package_article.R)\n  - RStudio doc shortcut: `?pokemon` or `?pokemon-package`\n- Null Objects and `@rdname`\n  - Source: [R/null_object_and_rdname.R](https://github.com/jayqi/satRday-roxygen-talk/blob/master/pokemon/R/null_object_and_rdname.R)\n  - RStudio doc shortcut: `?translate_to_pokemon`, `?translate_to_pikachu`, `?translate_to_squirtle`\n- Parameter Inheritance\n  - Source: [R/parameter_inheritance.R](https://github.com/jayqi/satRday-roxygen-talk/blob/master/pokemon/R/parameter_inheritance.R)\n  - RStudio doc shortcut: `?whos_that_pokemon`\n- Section Inheritance\n  - Source: [R/section_inheritance.R](https://github.com/jayqi/satRday-roxygen-talk/blob/master/pokemon/R/section_inheritance.R)\n  - RStudio doc shortcut: `?Wartortle`\n\n\u003csup\u003eDisclaimer: The author of this repository claims no ownership over Pokémon or related characters. Pokémon and all related characters are trademarks of Nintendo. The presentation and demo package uses Pokémon under fair use, and all materials should only be used for personal, noncommercial purposes.\u003c/sup\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayqi%2Fsatrday-roxygen-talk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjayqi%2Fsatrday-roxygen-talk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayqi%2Fsatrday-roxygen-talk/lists"}