Skip to content

DigitalCausalityLab/demo_repo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A Demo GitHub Repository for a Causal Case Study

This repository is created for demonstration purposes. Version control with Git and GitHub is taught in the Digital Causality Lab.

First steps in GitHub

Participants of the Digital Causality Lab should use this repo as a template and do the following steps.

  1. Create your own GitHub repository.
  • You can either navigate to your GitHub profile, go to the repositories tab and click on new, or,
  • You can use this template by clicking on the Use this template button.
  1. Open an issues with a task. For example, the title could be "Add some content to the README.md file".
  2. Create a new branch, e.g., named changes-to-readme.
  3. Make changes to your files on this branch and commit them with a message. Push the changes.
  4. Open a pull request and review your changes.
  5. Merge the pull request and pull the main branch again. Verify that your changes have been merged.

Repo Structure

After you've completed the previously described steps, please remove the content above. Include the following information in this readme file:

Title of Case Study

  • Please include the title of your case study; an overview of all case studies is available here

Participants

  • Please list the names and GitHub user names here

Abstract

  • Insert a brief description of the goals and results of your case study (around 250 words, English)
  • You can upload and include figures, too

Current State and Call for Extension

  • Briefly summarize the state of your data product as of the end of the course
  • Briefly summarize what could be added or improved in the future

Organization of the Repo

We'd recommend you to organize your repo as follows.

  • Include figures (.jpg, .png, ...) in a subdirectory called figures/, see this example
  • Include data files (.csv, .rda, ...) in a subdirectory called data/, see this example
  • Include your R code (.R files) in a subdirectory called R, see this example
  • In case you use quarto for your data product, include your .qmd files here, see this example

These basic recommendations are intended to give you a bit structure. You can deviate from them as you like but please make sure others should be able to understand what you did. 😄