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

Restructure README and add Getting Started vignette #521

Merged
merged 10 commits into from
Jan 9, 2024

Conversation

jamesmbaazam
Copy link
Contributor

@jamesmbaazam jamesmbaazam commented Nov 24, 2023

This PR closes #482 by moving The Quick Start section of the README to a Getting Started vignette ("EpiNow2.Rmd") and rewording sections of the new README and vignettes for flow and clarity.

Treat this PR as a complete rewrite of the README especially and suggest ways to improve current change.

@jamesmbaazam jamesmbaazam reopened this Nov 24, 2023
@jamesmbaazam jamesmbaazam marked this pull request as draft November 24, 2023 16:12
@jamesmbaazam jamesmbaazam added the documentation Improvements or additions to documentation label Nov 24, 2023
@jamesmbaazam jamesmbaazam added this to the CRAN v2.0 release milestone Nov 24, 2023
@jamesmbaazam jamesmbaazam marked this pull request as ready for review November 24, 2023 19:51
@jamesmbaazam jamesmbaazam requested review from sbfnk and seabbs November 24, 2023 19:51
@jamesmbaazam jamesmbaazam self-assigned this Nov 27, 2023
sbfnk
sbfnk previously approved these changes Nov 28, 2023
Copy link
Contributor

@sbfnk sbfnk left a comment

Choose a reason for hiding this comment

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

I think this is a good change - really liking the new README. I left a few comments for things that I stumbled across while reading, most of which are not related to this PR and can be dealt with in separate issues/PRs.

README.Rmd Outdated Show resolved Hide resolved
README.Rmd Outdated Show resolved Hide resolved
README.Rmd Outdated Show resolved Hide resolved
README.Rmd Outdated Show resolved Hide resolved
README.Rmd Outdated Show resolved Hide resolved
vignettes/EpiNow2.Rmd Outdated Show resolved Hide resolved
Copy link
Contributor

@seabbs seabbs left a comment

Choose a reason for hiding this comment

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

This is really nice and a solid improvement. As @sbfnk suggests I would go with ordering the intro using the estimate_ functions vs the current approach. We also need to check CRAN policy to see what the new/views are on relative links. Finding a CRAN package that has them would also be good enough evidence for me.

Note: Either this PR or #504 are going to have some major merge issues. I suggest getting in quick.

README.Rmd Outdated Show resolved Hide resolved
README.Rmd Outdated Show resolved Hide resolved
@jamesmbaazam jamesmbaazam force-pushed the split-readme-to-vignette branch 2 times, most recently from f9d921b to 20e8593 Compare December 1, 2023 22:42
@seabbs
Copy link
Contributor

seabbs commented Dec 21, 2023

Where are we on this?

@jamesmbaazam jamesmbaazam force-pushed the split-readme-to-vignette branch from fdcaded to 3ba2d1f Compare January 9, 2024 11:30
@jamesmbaazam
Copy link
Contributor Author

Where are we on this?

I just rebased again. We can merge if it looks good.

@jamesmbaazam
Copy link
Contributor Author

@seabbs I think this is ready to be merged.

Copy link
Contributor

@seabbs seabbs left a comment

Choose a reason for hiding this comment

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

This is really nice. LGTM

@seabbs seabbs merged commit bcf297c into main Jan 9, 2024
12 checks passed
@seabbs seabbs deleted the split-readme-to-vignette branch January 9, 2024 18:44
sbfnk pushed a commit that referenced this pull request May 3, 2024
* Restructure README

* Add Getting Started Vignette

* Automatic readme update

* Precompile Getting Started vignette

* Fix partial matching

* Use relative links

* Restructure models section

* Wrap package name in braces

* Automatic readme update

* Format package name

---------

Co-authored-by: GitHub Action <[email protected]>
sbfnk pushed a commit that referenced this pull request May 3, 2024
* Restructure README

* Add Getting Started Vignette

* Automatic readme update

* Precompile Getting Started vignette

* Fix partial matching

* Use relative links

* Restructure models section

* Wrap package name in braces

* Automatic readme update

* Format package name

---------

Co-authored-by: GitHub Action <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

Quick start in README vs. workflow vignette
4 participants