praise: Publish praise about 'texreg'

View source: R/praise.R

praiseR Documentation

Publish praise about texreg

Description

Publish praise about texreg to help the developers demonstrate impact.

Usage

praise(
  academic_user,
  organization,
  name = NULL,
  general_praise = NULL,
  increase_productivity = NULL,
  increase_quality = NULL,
  start_using = NULL,
  where_learn = NULL,
  contact_details = NULL,
  models = NULL,
  num_users = NULL,
  return.response = FALSE
)

praise_interactive()

Arguments

academic_user

Should be TRUE if you are at a university or public research institute. Should be FALSE if you are a private user, for example you are using texreg in your work for a firm, NGO, association, government department, as an individual user etc. We particularly need praise from non-academic users to demonstrate societal impact, but we can also make the case for academic usage to generate impact indirectly.

organization

Please tell us the name of the organization for which you are using texreg. If we can show that the package is being employed in a number of different settings, this will help us demonstrate impact.

name

(Optional) We would be delighted to to know who you are. After all, we can quote you much more effectively if we can tell the funders and employers who provided this praise! If possible, include your title.

general_praise

Use this argument to provide general praise, for example about the way it was designed, the user support you have received, or just how much you enjoy using it. While this is useful, however, we would be even more interested in receiving statements in how texreg makes you more productive (in the increase_productivity argument) or how it increases the quality of your work or your reports (through the increase_quality argument). Note: you need to provide at least one of these three free-form text arguments.

increase_productivity

This is one of the fields we are most interested in. Please use this field to tell us how texreg is making you more productive. For example, does it speed up writing your articles or research reports? Does it enable you to skip manual work like copy and paste of your results into your reports, or to avoid fiddling with table formatting? How much time has it saved you so far? Are there any other benefits in terms of productivity you can think of? Note: you need to provide feedback using at least one of the three free-form arguments (general_praise, increase_productivity, or increase_quality).

increase_quality

This is one of the fields we are most interested in. Please use this argument to tell us how texreg increases the quality of your work or the quality of your reporting. For example, does the package generate tables that look more professional than the tables you used to create manually? Are you using screenreg to improve your workflow by understanding better how the results of multiple models compare? Are you using plotreg to visualize and present your statistical results in a more effective way? Can you think of any other ways in which texreg is helping you? Note: you need to provide feedback using at least one of the three free-form arguments (general_praise, increase_productivity, or increase_quality).

start_using

(Optional) When did you start using texreg? We are interested in the approximate time or year as a free-form text argument, for example "back in 2013 when the JSS article came out".

where_learn

(Optional) Where or how did you learn about the texreg package?

contact_details

(Optional) Tell us how we can contact you in case we would benefit from additional information. This might help us further down the road in compiling an impact case study or a similar report. Don't worry, this information will not be displayed on the website!

models

(Optional) Which kinds of statistical models do you use in your work? For example, "Mostly linear models, but also lme4 and ergm.".

num_users

(Optional) How many other texreg users do you know? In particular, if you are a non-academic user, would you mind telling us how many other non-academic users you are aware of and how many of them are in your organization? The more we know, the more convincing our evidence base will be. This argument accepts numeric values or more detailed responses as a character object.

return.response

If TRUE, a website with the submitted data will be returned as a response object, as defined in the httr package. You can load the httr package and use the content function, possibly enclosed in an as.character call, to inspect the output and diagnose any problems with the transmission of the data. Only use this argument if instructed by the package authors.

Details

The praise_interactive function asks you 11 questions interactively on the R console. You can choose to answer or skip them. Some questions are mandatory but most are optional. After collecting your answers, it will call the praise function to submit your praise. You can also choose to use the praise function directly and supply your answers as arguments. Either way is fine.

Before your praise is submitted, the functions will present an interactive menu and ask if you want to submit the praise now. So do not worry about accidentally submitting feedback.

You can use these functions to praise the texreg package. Funders and academic employers are increasingly interested in seeing evidence for the impact academic research generates. For software, such as texreg, this is very hard to accomplish because the developers are usually disconnected from the users. The consequence is that incentives for developing packages like these are diminishing the more the funders and employers require evidence of impact on society, firms, or policy makers.

The praise and praise_interactive functions are our attempt at rectifying the situation. With these functions, you can provide positive feedback to the developers. The praise is saved to a database on the web server of the package maintainer and subsequently displayed at https://www.philipleifeld.com/praise/ for other users, funders, and employers to view. This will also enable the package authors to compile reports about how texreg is used by academic and non-academic users to increase their productivity and work quality, for example in the form of an impact case study for the next round of the UK Research Excellence Framework (REF).

We need many positive examples of how texreg has an impact on your work. We are especially interested in non-academic users, but welcome feedback from anyone. So please contribute by using the praise function! Tell us how cool this package is and how it has changed your work!

The minimal information we require from you is whether you are an academic or non-academic user, the name of your organization, and some free-form praise (of a general nature, or about how it makes you more productive, or about how it increases the quality of your work or reporting). But there are some additional fields. While we are happy with the basic information, of course we will be happier if we also know your name, how to contact you, what kinds of models you work with, and some other details. Your choice!

Please note that by using the praise or praise_interactive function you agree that the information you provide through the function, including your approximate location, is stored online in a database, displayed on the website of the package author, and used in reports to funders, employers etc. (This is the whole purpose of it.) You can contact the package maintainer any time to have your praise removed within a few days.

Value

If everything works well, no output is returned (but see the return.response argument to change this). If the submission of the praise to the maintainer fails, a response object (as defined in the httr package) will be returned. Should you have any problems, do feel free to e-mail your praise to the package maintainer directly.

Author(s)

Philip Leifeld

Examples

## Not run: 
praise(academic_user = TRUE,
       organization = "University of Happy Tables",
       increase_quality = "Man, I've never seen such pretty tables!")

## End(Not run)


texreg documentation built on Sept. 11, 2024, 6:41 p.m.