Skip to content

Latest commit

 

History

History
43 lines (24 loc) · 3.14 KB

README.md

File metadata and controls

43 lines (24 loc) · 3.14 KB

{surveyDesigner}

Codecov test coverage Lifecycle: experimental

{surveyDesigner} is a shinyApp to parse a master referential of questions and indicators to generate a contextualized series of xlsform questionnaires.

For the end-user, aka the Survey Coordinator at Operation level, the application is expected to:

  1. Enforce a questionnaire design process that starts from a selection of indicators that needs to be measured and pre-select automatically all the required standardized survey modules and questions in order to measure them. Not only this shall ensure that standards are actually used, but it will also minimize the risk of questionnaire design mistakes: "collect what you need, use what you collect"

  2. Ease the contextualization process from the global referential to the actual implementation in each country (i.e translating and adjusting the labels as per the specific context) and facilitate the feedback loop so that if the same ad-hoc questions are used in multiple context, they can be considered for inclusion in the global referential

  3. Support the usage of mixed-mode (CAPI/CATI/CAWI) and multiple data collection waves to collect the final dataset within an annual survey data collection cycle, all of this allowing both to promote survey integration and to maximize the financial resources invested in those activities

Overall, this will contribute over time to the creation of standardized survey-based indicators for comparative data analysis across countries and contexts.

Read more on the rationale for this app in the vignette or go through the wiki to go through the technical specifications

Run the app

⚠️ surveyDesigner is currently under development... 🚧 - the prototype is accessible here: https://rstudio.unhcr.org/Survey_Designer/

To run it locally, use

# install.packages("pak")
pak::pkg_install("unhcr-americas/surveyDesigner")
# Run the application
surveyDesigner::run_app()

For developpers

The app is build using {golem} framework and following the tutorial: Engineering Production-Grade Shiny Apps.

Please note that the surveyDesigner project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.