The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.

Form: Inclusive General-Purpose Registration Form (v1.1)

This vignette shows an inclusive general-purpose registration form (previous versions of this form: v1.0). It can be initialized as follows:

initialized_generalPurpose_v1 <-
  preregr::prereg_initialize(
    "generalPurpose_v1_1"
  );

After this, content can be specified with preregr::prereg_specify() or preregr::prereg_justify. To check the next field(s) for which content still has to be specified, use preregr::prereg_next_item().

The form’s metadata is:

field content
title Inclusive General-Purpose Registration Form
author Gjalt-Jorn Peters & Szilvia Zörgő
date 2022-01-11
comments This form was heavily based on the Inclusive Systematic Review Form by Van den Akker et al. (2020).
version 1.1

The form is defined as follows (use preregr::form_show() to show the form in the console, instead):

preregr::form_knit(
  "generalPurpose_v1_1"
);

Inclusive General-Purpose Registration Form

Instructions

Intended Use

This Inclusive General-Purpose Registration Form is designed to be applicable across disciplines (i.e., psychology, economics, law, physics, or any other field) and across study types (i.e., qualitative studies, quantitative studies, experiments, systematic reviews, case studies, archive studies, comparative legal studies, or any other type of study). This form, therefore, is a fall-back for more specialized forms and can be used if no specialized form or registration platform is available. As such, if at all possible, it is recommended to avoid using this form and instead use a specialized form. This inclusive general-purpose registration form achieves that inclusiveness and general-purposeness at the cost of specificity and comprehensiveness. Still, if specialized forms don’t fit for your study, this form may be a good backup.

Sections and items

Section: Metadata

Discipline
discipline
Here you can specify your discipline (e.g. law, chemistry, anthropology, etc).
Title
title
The title of this study (at this stage, anyway).
Author(s) / contributor(s)
authors
The authors of / contributors to this study.
Tasks and roles
tasks_and_roles
Describe the expected tasks and roles of each author/contributor, for example using the Contributor Roles Taxonomy (CRediT).
Funding
funding
List the funding sources for everybody that is involved in this study at this stage. If the work is not funded, please state this as such.
Conflicts of interest
cois
List any potential conflicts of interest (e.g., if there is a potential outcome of this study that can in any way have negative or positive effects for anybody involved in this study in terms of funding, prestige, or opportunities). If there are no conflicts of interest, please state this as such.

Section: Background

Type of study
type_of_study
How would you describe the type of study you are (pre)registering (examples are “systematic review”, “cost-effectiveness trial”, or “observational study”, but use your own words)?
Background
background
Introduce the topic of your study, its aims, and/or provide a short summary of known literature and what you want to add to this literature with your study.
Philosophy of Science
philsci
Describe the relevant elements of your ontological perspective (e.g. realism, relativism, pragmatism) and your epistemological perspective (e.g. empiricism, constructivism, skepticism), that is, those elements that are most relevant as a basis for the methodological choices you make in this study.
Positionality
positionality
Describe how you (as a person) see your association with the studied phenomenon, describe your position in the research setting / field, and describe your academic and personal standpoints, assumptions and values (to the degree that they may shape how you approach this study). You don’t need to repeat what you already describe in the items “Conflicts of interest” and “Philosophy of Science” (both in the Background section) and “Expectations / hypotheses” (in the Methods section). Instead you can use this item to enter information that wouldn’t fit there but that might nonetheless potentially color your interpretations or otherwise shape your approach.
Study stages
stages
Indicate the stages in which you will conduct this study. Common stages are preparation, data collection, and analysis, specify the stages you will use using your own words.
Current study stage
stage
From the list you specified in the “Study stages” item, indicate in which stage you are at this moment (i.e., when you freeze this registration).
Start date
start_date
Indicate the planned start date, or if you already started, the actual start date.
End date
end_date
Indicate the planned end date, or if you already completed the study, the actual end date.

Section: Methods

Primary research question(s)
primary_research_question
List the specific questions this study is meant to answer (i.e., the questions that ultimately informed the decisions made when designing the study plans you are registering). Note that all analyses pertaining to primary research questions should normally be reported in the final report.
Secondary research question(s)
secondary_research_question
List additional research questions that you will examine, but that took less central roles in informing the study’s design. Note that all analyses pertaining to secondary research questions should normally be reported in the final report (the difference is that the study’s design is mainly geared towards answering the primary research questions).
Expectations / hypotheses
expectations_hypotheses
Describe any hypotheses and/or expectations you have. These can pertain to your research questions, the types of sources you will find, social and political contexts, and contextual information that you know may color your interpretations and decisions.
Main variable(s) / outcome(s) / dependent variables
main_vars
List the concepts or main / dependent / outcome variables you are interested in. If this study concerns one or more associations, list the outcome variable(s) or dependent variables. If this study does not concern one or more associations, list the main variables of interest here.
Secondary variable(s) / independent variable(s) / intervention(s) / treatment(s)
secondary_vars
If this study’s research question(s) concerns one or more associations or effects, list the variable(s) that theoretically cause them or are assumed to otherwise explain the main variable(s) / dependent variable(s) / outcome(s). If this is a manipulation, treatment, or intervention, make sure to describe it in full: that means also describing all groups, including any control group(s) or comparator(s). If there are no secondary variables, you can just state that.
Additional variable(s) / covariate(s)
additional_vars
Here, list any additional variables you are interested in that were not included in the two lists above, such as covariates, moderators, or mediators. If there are no additional variables, you can just state that.
Data origin
data_origin
Describe the origin of the data you will examine. Data here is meant as a broad term: it refers to primary or secondary data; data you will collect or data that already existed; data that are measurements, recordings, existing documents or reports. Basically, which bits of the world will you look at to answer your research question(s), and how will you obtain those bits? For example, will you study humans, animals, chemicals, laws? Which procedures do you plan to employ? If your study does not involve the analysis of data at all, you can also indicate that here (but in that case this form will probably mostly not be applicable).
Data sampling
data_sampling
Describe whether you will sample your data from a larger population. If not (i.e. if you will study an entire population), you can also indicatie that here. If you do plan to sample from a larger set of potential research units, this is where you can describe your sampling procedure, explain why that procedure fits with your goals, and explain how you will minimize bias (e.g. various forms of selection bias). If you aim to obtain a sample with specific characteristics (e.g. stratified according to some variable or optimized for heterogeneity in some respects), you can also describe that here, explain why you strive for that, and explain why you believe that your procedure will achieve your aims.
Data registration
data_registration
Describe how you will register your data. If you will obtain your data through measurement, state the measurement instruments that you will use and expain your basis for assuming that those measurement instruments are appropriate (e.g., given the sample and context of your study). If you will not use measurement to obtain your data, explain how you will register the data you will use. Here, you can also explain what the data will look like after registration, for example by describing the columns in the dataset you will analyze, or the media you will use to store your data (e.g. bitrates).
Data bias minimization
data_bias_minimization
Describe whether any procedures are in place to minimize bias that may be introduced as data are obtained. For example, will masking be applied? If data will be collected by people, will they be masked from the implications of patterns in the data for the research questions? If data will be collected from people (e.g., archivists, clerks, or research participants), will they be masked from the researchers’ expectations regarding those data? If data are collected by an automated procedure (e.g., scraping websites), will the algorithms performing the data collection be vetted by others to try to identify biases? If no procedures will be implemented to minimize bias, you can also indicate and explain that here.
Amount of data to be collected
data_amount
Describe how much data you plan to collect. For example, here you can explain whether you will study one research unit (often referred to as a case study), study the entire population, or for anything in between, how much data you plan to collect and why. If your data consists of archival records, social media data, case law, or chat logs, you can explain how many data sources you will analyse. If you will collect qualitative data, you can describe how much you plan to collect, and if you use saturation as a stopping rule, how you operationalize saturation. If you will conduct quantitative analyses, you can describe your sample size computations and which parameters you use (e.g. SESOI, alpha, power). In all cases, this is also where you explain why that amount of data is appropriate given your aims. If you have no specific plans for how much data you will collect, you can also explain that here.
Anyware
anyware
List the software and hardware you plan to use for the study. Include model/version numbers, producers, and operating systems, if applicable.
Repositories
repositories
List the repositories you will use to publish your data, analyses, materials, and documentation. If you do not plan to publish one or more of these, you can indicate and explain that here.
Preprint server
preprint
Indicate which preprint server you plan to use to publish the preprint(s) from this project. If you do not plan to publish a preprint, you can indicate and explain that here.
Miscellaneous methods details
misc_methods_details
Here, you can describe any details that are not captured in the other fields in this section.

Section: Analyses

Missing data
missing_data
Describe how you plan to deal with missing data (e.g. observations that cannot go through as planned, archive materials that cannot be obtained, problems with recordings, missing data points, participants who drop out, etc).
Data validation
data_validation
Describe your process of ensuring that the data are correct and useful (e.g., identifying outliers, establishing correct and valid application of measurement instruments, triangulating with other sources, or other methods of verifying data integrity). Also describe your criteria for assessing data validity and how you will deal with data violating those criteria. Or, if you will not assess the correctness, usefulness, or validity of your data, you can explain that here.
Analysis plan
analysis_plan
Describe the specific procedure you will apply to arrive at an answer to the research question(s). If you distinguish analysis tiers (e.g., primary and secondary analyses, or confirmatory and exploratory analyses), list them and indicate which procedures you plan to use for each. Also specify what you will do if parts of the plan cannot be properly executed. This is also where you can explain your reasons for assuming that your chosen procedure is appropriate to arrive at the answers you seek.
Criteria for conclusions / inference criteria
criteria_for_conclusions
If you plan to draw your conclusions based on pre-specified criteria (e.g., a minimal effect size of interest, a significance level, or a saturation point), list these here, explain what they were based on, and explain your reasoning. If you plan to draw conclusions but will not use pre-specified criteria, you can explain why you will establish criteria later, by what procedure, and how you plan to ameliorate the risk of bias. Finally, if you will not draw any inferences (e.g., about theories or hypotheses), you can also explain that here.
Analyst masking
analyst_masking
Describe the procedure, if any, used to mask analysts (i.e., the person(s) analyzing the extracted data to arrive at answers to your research question(s)) from the research questions, expectations, hypotheses, and/or specific roles of each variable in this study. If you decide to not use masked analysists, you can state that decision here.
Miscellaneous analysis details
misc_analysis_details
Here, you can describe any details that are not captured in the other fields in this section.

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.