diff --git a/README.md b/README.md index d6690b5..34ffc15 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,34 @@ -# CausalTesting-Artifact_ICSE20 -This repository contains the components of the ICSE 2020 technical research paper "Causal Testing: Understanding Defects' Root Causes". +# Causal Testing Artifact (ICSE 2020) + +This is the artifact for the paper *"Causal Testing: Understanding +Defects' Root Causes"*. This artifact replicates the user study setup +used to evaluate our technique, including the supplementary data +collection materials. + +## What is included in the artifact? + +Our artifact includes the following: + +1. A virtual machine file (CausalTesting_Artifact.ova) that contains +the user study setup and version of Holmes used. + +2. The form participants completed as they worked through +each defect in the user study (Cause-Identification-Form.pdf). + +3. The post-questionnaire participants filled out as a form of +debriefing following the study (Evaluation-Questionnaire.pdf) + +4. The demographic questionnaire used to gather information about our + participants background and experience (Demographic-Questionnaire.pdf). + +5. The script used to explain to participants what they would be doing + during the user study (User-Study-Script.pdf). + +## Where can I obtain the artifact components? + +All the above listed artifacts can be found in the following github +repository: + +The **INSTALL.md** file provides details on how to set up and run the +virutal machine. The other components of the artifact are made +available for exploration and re-use.