Merge pull request #20 from unhcr-americas/11-as-dev-i-would-like-to-…

…wireframe-the-ui-in-order-to-give-preview-and-create-engagement

11 as dev i would like to wireframe the UI in order to give preview and create engagement

README.md

@@ -6,69 +6,37 @@
 [![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)
 <!-- badges: end -->
 
+`{surveyDesigner}` is a shinyApp to parse a master referential of questions and indicators to generate a contextualized series of [xlsform](http://xlsform.org) questionnaires.
 
-`{surveyDesigner}` is a shinyApp to parse a master XlsForm to generate a contextualized questionnaire.
 
-The app is build using [`{golem}` framework](https://thinkr-open.github.io/golem) and following the tutorial: [Engineering Production-Grade Shiny Apps](https://engineering-shiny.org//).
+For the end-user, aka the Survey Coordinator at Operation level, the application is expected to: 
 
-Read more on the rationale for this app in the [vignette](https://unhcr-americas.github.io/surveyDesigner/docs/articles/surveyDesigner.html)
+  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 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)](https://www.youtube.com/watch?v=qRmy2OAnyWc) 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  
 
-## Installation
+Overall, this will contribute over time to the creation of [standardized survey-based indicators](https://egrisstats.org/resource/data-disaggregation-of-sdg-indicators-by-forced-displacement/) for comparative data analysis across countries and contexts.
 
-You can install the development version from [GitHub](https://github.com/Thinkr-open/golem) with:
+Read more on the rationale for this app in the [vignette](https://unhcr-americas.github.io/surveyDesigner/docs/articles/surveyDesigner.html) or go through the [wiki](https://github.com/unhcr-americas/surveyDesigner/wiki) to go through the technical specifications
 
-``` r
-# install.packages("remotes")
-remotes::install_github("unhcr-americas/surveyDesigner")
-```
 
 ## Run the app  
-This script allows you to display the app
 
-``` r
-# Run the application
-surveyDesigner::run_app()
-```
+The app is still under development - the prototype is accessible here: https://rstudio.unhcr.org/Survey_Designer/ 
 
-## Update the app  
-This script allows you to quickly rebuild and display the app
+To run it locally, use
 
 ``` r
-# Detach all loaded packages and clean your environment
-golem::detach_all_attached()
-
-# rm(list=ls(all.names = TRUE))
-
-# Document and reload your package
-golem::document_and_reload()
-
+# install.packages("remotes")
+remotes::install_github("unhcr-americas/surveyDesigner")
 # Run the application
 surveyDesigner::run_app()
 ```
 
+## For developpers
 
-
-## Update the package documentation
-
-This script allows to update the package documentation
-
-``` r
-devtools::document()
-
-devtools::check(document = FALSE)
-
-pkgdown::build_site()
-```
-
-## As dev :
-
-Please use template commit and MR :
-
-``` r
-project_path <- "path_to_surveyDesigner"
-gert::git_config_set(repo = project_path, name = "commit.template", value = ".github/template_commit")
-```
-
-## Code of Conduct
+The app is build using [`{golem}` framework](https://thinkr-open.github.io/golem) and following the tutorial: [Engineering Production-Grade Shiny Apps](https://engineering-shiny.org//).
 
 Please note that the surveyDesigner project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.