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

Split vignette in "for users" and "for developers"? #90

Open
Bisaloo opened this issue Oct 29, 2020 · 1 comment
Open

Split vignette in "for users" and "for developers"? #90

Bisaloo opened this issue Oct 29, 2020 · 1 comment

Comments

@Bisaloo
Copy link
Contributor

Bisaloo commented Oct 29, 2020

Hi,

I think it'd be super useful to have a vignette that is targeted at end users of packages relying on progressr. I want to direct users of my packages to a short explanation about how that they can enable progress report if desired, and customize the type of report. However, the current vignette also provides information about the philosophy of the package, and information to package developers, which may be not relevant, and could overthrow a user that just wants a simple explanation on how to get a progress bar.

The drat package takes this approach of offering two vignettes and I find it very helpful.

I've thought about putting this introduction in my own package but I think it makes more sense if it's within progressr since it'd be useful for many other packages depending on progressr.

@HenrikBengtsson
Copy link
Collaborator

Yes, this is a great suggestion. The reason for the current, rather long, vignette/README is that it grew out of my own personal note when I prototyped this package (which was only meant to be a proof-of-concept package). There are new things planned for the package (e.g. global calling handlers) that will further affect "best practices for developers" and "best practices for users". When that is in place, I'll revisit the vignette structure.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants