Skip to content

Latest commit

 

History

History
68 lines (51 loc) · 3.24 KB

README.md

File metadata and controls

68 lines (51 loc) · 3.24 KB

Thesis / Paper Title

This repository is a companion page for the following thesis / publication:

Author Names. Publication year. Thesis / Paper title. Publication venue / proceedings.

It contains all the material required for replicating the study, including: X, Y, and Z.

How to cite us

The scientific article describing design, execution, and main results of this study is available here.
If this study is helping your research, consider to cite it is as follows, thanks!

@article{,
  title={},
  author={},
  journal={},
  volume={},
  pages={},
  year={},
  publisher={}
}

Quick start

Here a documentation on how to use the replication material should be provided.

Getting started

  1. Provide step-by-step instruction on how to use this repository, including requirements, and installation / script execution steps.

  2. Code snippets should be formatted as follows.

    • git clone https://github.com/S2-group/template-replication-package
  3. Links to specific folders / files of the repository can be linked in Markdown, for example this is a link to the src folder.

Repository Structure

This is the root directory of the repository. The directory is structured as follows:

template-replication-package
 .
 |
 |--- src/                             Source code used in the thesis / paper
 |
 |--- documentation/                   Further structured documentation of the replication package content
 |
 |--- data/                            Data used in the thesis / paper 
        |
        |--- additional_subfolder/     Subfolders should be further nested to increase readability                 

Usually, replication packages should include:

  • a src folder, containing the entirety of the source code used in the study,
  • a data folder, containing the raw, intermediate, and final data of the study
  • if needed, a documentation folder, where additional information w.r.t. this README is provided.

In addition, the replication package can include additional data/results (in form of raw data, tables, and/or diagrams) which were not included in the study manuscript.

Replication package naming convention

The final name of this repository, as appearing in the published article, should be formatted according to the following naming convention: <short conference/journal name>-<yyyy>-<semantic word>-<semantic word>-rep-pkg

For example, the repository of a research published at the International conference on ICT for Sustainability (ICT4S) in 2022, which investigates cloud tactics would be named ICT4S-2022-cloud-tactics-rep-pkg

Preferred repository license

As general indication, we suggest to use:

For more information on how to add a license to your replication package, refer to the official GitHUb documentation.