Skip to content
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

Docs review #149

Merged
merged 16 commits into from
Aug 21, 2023
Merged

Docs review #149

merged 16 commits into from
Aug 21, 2023

Conversation

capnrefsmmat
Copy link
Contributor

Here's an initial batch of changes from reading through the package documentation this morning, and running devtools::check(remote=TRUE). Each commit is small and the message should explain the purpose, so it may be easier to review each commit separately.

Copy link
Contributor

@dsweber2 dsweber2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Glad to see this! Only one code style thing I might disagree with, otherwise lots of necessary fixes.

@@ -32,10 +32,10 @@ parse_signal <- function(signal, base_url) {
}

#' @export
print.covidcast_data_signal <- function(signal, ...) {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure why you're preferring a more generic variable name?

Copy link
Contributor Author

@capnrefsmmat capnrefsmmat Aug 16, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We're required to use x, because that's how print() is defined in base R:

> print
function (x, ...) 
UseMethod("print")

See https://cran.r-project.org/doc/manuals/r-release/R-exts.html#Generic-functions-and-methods

This is checked by R CMD check, which issues warnings when the argument names don't match.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What a peculiar bit of boilerplate. I'll definitely be taking your word for it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Was also curious, thanks!

R/endpoints.R Outdated Show resolved Hide resolved
@@ -14,18 +14,49 @@ library(epidatr)
library(dplyr)
```

The epidatr package provides access to all the endpoints of the [Delphi Epidata
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

definitely needed to be less sparse

@capnrefsmmat
Copy link
Contributor Author

Pushed a fix for the error message saying data_source when it should say source, plus a couple other fixes. If you can review and merge this before the meeting this week, that'd be great, since it'll let the review start from here.

Copy link
Contributor

@dshemetov dshemetov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for this pass Alex, overall looks great.

  • Made one typo change
  • We tentatively decided to keep covidcast_epidata() private because we weren't sure if the interface was going to change. I'm fine with re-exporting it, merging it in for now, and discussing it tomorrow. Can always revert later.

vignettes/epidatr.Rmd Outdated Show resolved Hide resolved
@dshemetov dshemetov merged commit 7a5bcb7 into dev Aug 21, 2023
3 checks passed
@dshemetov dshemetov deleted the docs-review branch August 21, 2023 19:21
@dsweber2 dsweber2 added this to the Z: epidatr & epidatpy milestone Oct 23, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants