insightsengineering / insightsengineering/teal.widgets

[Feature Request]: Reorganize `roxygen2` tags

Open
#229 0 comments 0 reactions 0 assignees View on GitHub
core documentation enhancement
Dominant language
R
Stars
6
Forks
8
PR merge metrics
No merged PRs in 30d

Description

During pre-releases of other `teal` packages (e.g. this https://github.com/insightsengineering/teal.modules.general/issues/624) we agreed on a specific order of `roxygen2` tags

Standard order of roxygen2 tags
* `@title ➡️ @doctype ➡️ @description ➡️ @details ➡️ @rdname ➡️`
* `➡️ @inheritParams ➡️ @params ➡️ @return ➡️ @seealso ➡️ @references ➡️`
* `➡️ @examples ➡️ @export ➡️ @keywords ➡️ @noRd`

Apply for this package as well.
Enhancement: consider `@aliases` (just before the `@export`) and `@usage` tag (just after `@description`)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.