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

Review tmhermes documentation before release #307

Closed
donyunardi opened this issue May 25, 2023 · 7 comments
Closed

Review tmhermes documentation before release #307

donyunardi opened this issue May 25, 2023 · 7 comments
Assignees
Labels

Comments

@donyunardi
Copy link
Contributor

donyunardi commented May 25, 2023

Summary

Related with insightsengineering/nestdevs-tasks#25
and also: #294
In preparation to release, we need to review/assess all documentation in the package.

Acceptance Criteria

  • Review roxygen examples on all functions
    • Test examples
    • If it's using chunk, update to qenv.
  • Review vignettes on these topics only:
    • Review any content around qenv
    • Review any content around chunks (i.e. make sure the right language around deprecation)
    • Review any content around shinyvalidate
  • redo the content of WORDLIST
  • Update NEWS
  • Update README (if applicable)
  • Review DESCRIPTION file (i.e check dependency versions, etc)
    • Be sure to update teal.code dependency to be >= 0.3.0
@donyunardi
Copy link
Contributor Author

Closing this issue as chunks is not used in this module.

Confirmed that the chunks mentioned here is just a design files and not part of R package (see comment here).

@danielinteractive please update the mentioned design files to use qenv if needed and remove any reference to chunks to avoid future confusion.

@donyunardi
Copy link
Contributor Author

Sorry, reopen this again.
Even though chunks is out of the picture, we still need to release this due to update during the refactor:
#294

@m7pr
Copy link
Contributor

m7pr commented Jul 12, 2023

Hey @gogonzo I did review this package. There is no use of teal.code::chunks in examples, regular code nor vignettes. The only place this is used is a design/ folder (those two files https://github.com/search?q=org%3Ainsightsengineering+repo%3Ainsightsengineering%2Fteal.modules.hermes++chunks&type=code) but this folder is listed in .Rbuildignore so it's not a part of the package.

Also no need to add teal.code to dependencies in DESCRIPTION

@gogonzo
Copy link
Contributor

gogonzo commented Jul 12, 2023

This design directory should be either removed or chunks should be replaced by qenv. chunks will disappear forever.
@danielinteractive please select what you prefer

  • remove
  • replace with qenv

@danielinteractive
Copy link
Collaborator

danielinteractive commented Jul 12, 2023

@gogonzo the point is that design folder contains many outdated things, it is a memory of the project. Therefore you can consider this as it does not have to work at all, but it can be helpful later for us when understanding the history. so we can just keep it like it is.
as mentioned, it is not part of the R package.

@gogonzo
Copy link
Contributor

gogonzo commented Jul 12, 2023

@gogonzo the point is that design folder contains many outdated things, it is a memory of the project. Therefore you can consider this as it does not have to work at all, but it can be helpful later for us when understanding the history. so we can just keep it like it is. as mentioned, it is not part of the R package.

Fair enough. Danke schön!

@m7pr
Copy link
Contributor

m7pr commented Jul 12, 2023

so I guess we can close this issue

@m7pr m7pr closed this as completed Jul 12, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

4 participants