Human and Machine-Readable Justifications and Justified Decisions Based on 'YAML'

Leverages the 'yum' package to implement a 'YAML' ('YAML Ain't Markup Language', a human friendly standard for data serialization; see < https://yaml.org>) standard for documenting justifications, such as for decisions taken during the planning, execution and analysis of a study or during the development of a behavior change intervention as illustrated by Marques & Peters (2019) . These justifications are both human- and machine-readable, facilitating efficient extraction and organisation.

justifier 📦

Human and Machine-Readable Justifications and Justified Decisions Based on ‘YAML’

The pkgdown website for this project is located at https://justifier.opens.science.

The goal of justifier is to provide a simple human- and machine-readable standard for documenting justifications for decisions. justifier was primarily developed to enable documenting the development of behavior change interventions and the planning and execution of scientific studies, but it can also be used to document decisions in organisations, enabling deriving insights in decision processes from the accumulation of decisions and types of justifications over time.

Three vignettes (in progress) are located at:

• https://justifier.opens.science/articles/general-introduction-to-justifier.html
• https://justifier.opens.science/articles/justifier-in-study-design.html
• https://justifier.opens.science/articles/justifier-in-intervention-development.html

This meets the increasing demand for accountability of professionals (see e.g. Van Woerkum & Aarts, 2012).

Installation

You can install the released version of justifier from CRAN with:

install.packages('justifier');

You can install the development version of justifier from Codeberg with:

remotes::install_git('r-packages/justifier');

(assuming you have remotes installed; otherwise, install that first using the install.packages function)

You can install the cutting edge development version (own risk, don’t try this at home, etc) of justifier from Codeberg with:

remotes::install_git('r-packages/justifier@dev');

References

van Woerkum, C. and Aarts, N. (2012), ‘Accountability: New challenges, new forms’, Journal of Organizational Transformation & Social Change, 9, pp. 271–283, .