-
Notifications
You must be signed in to change notification settings - Fork 60
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Closes #1698 1698_update_restrict)derivation_doc: Update description of derivation
argument
#1744
Conversation
R/call_derivation.R
Outdated
#' | ||
#' A function is expected. The function must provide the `dataset` argument | ||
#' and all arguments specified in the `params()` objects passed to the | ||
#' `variable_params` and `...` argument. Therefore it is not possible to | ||
#' specify dplyr functions like `mutate()` or `summarize()`. | ||
#' |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
#' | |
#' A function is expected. The function must provide the `dataset` argument | |
#' and all arguments specified in the `params()` objects passed to the | |
#' `variable_params` and `...` argument. Therefore it is not possible to | |
#' specify dplyr functions like `mutate()` or `summarize()`. | |
#' | |
#' | |
#' A function is expected. The function must provide the `dataset` argument | |
#' and all arguments specified in the `params()` objects passed to the | |
#' `variable_params` and `...` argument. Therefore, it is not possible to | |
#' specify `{dplyr}` functions like `mutate()` or `summarize()`. | |
#' |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe Therefore is the wrong word?? Perhaps Please Note
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Updated
R/slice_derivation.R
Outdated
#' A function is expected. The function must provide the `dataset` argument | ||
#' and all arguments specified in the `params()` objects passed to the `arg` | ||
#' argument. Therefore it is not possible to specify dplyr functions like | ||
#' `mutate()` or `summarize()`. | ||
#' |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
See above
@@ -6,6 +6,11 @@ | |||
#' | |||
#' @param derivation Derivation |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What is a Derivation? Could we say something about how the function is performing the derivation. I know what this is doing I just think a new user might be confused
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good point! I have added a short definition. Does it make sense?
I have also added it to the "Get Started" page.
In principle a glossary would be nice but hard to realize in R documentation.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Omg a glossary would be fantastic. I'm making an issue for this lol.
R/restrict_derivation.R
Outdated
#' A function is expected. The function must provide the `dataset` argument | ||
#' and all arguments specified in the `params()` objects passed to the `arg` | ||
#' argument. Therefore it is not possible to specify dplyr functions like | ||
#' `mutate()` or `summarize()`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
#' A function is expected. The function must provide the `dataset` argument | |
#' and all arguments specified in the `params()` objects passed to the `arg` | |
#' argument. Therefore it is not possible to specify dplyr functions like | |
#' `mutate()` or `summarize()`. | |
#' An `{admiral}` function that performs a specific derivation is expected. The function must | |
# ' provide the `dataset` argument | |
#' and all arguments specified in the `params()` objects passed to the `arg` | |
#' argument. Please note, it is not possible to specify `{dplyr}` functions like | |
#' `mutate()` or `summarize()`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Possible suggestion?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would not restrict to "admiral" because a derivation could be implemented in TA, company, or study specific admiral packages.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks awesome. I am serious about the glossary!
… argument
Thank you for your Pull Request! We have developed this task checklist from the Development Process Guide to help with the final steps of the process. Completing the below tasks helps to ensure our reviewers can maximize their time on your code as well as making sure the admiral codebase remains robust and consistent.
Please check off each taskbox as an acknowledgment that you completed the task or check off that it is not relevant to your Pull Request. This checklist is part of the Github Action workflows and the Pull Request will not be merged into the
devel
branch until you have checked off each task.styler::style_file()
to style R and Rmd filesdevtools::document()
so all.Rd
files in theman
folder and theNAMESPACE
file in the project root are updated appropriatelyNEWS.md
if the changes pertain to a user-facing function (i.e. it has an@export
tag) or documentation aimed at users (rather than developers)pkgdown::build_site()
and check that all affected examples are displayed correctly and that all new functions occur on the "Reference" page.lintr::lint_package()
R CMD check
locally and address all errors and warnings -devtools::check()