README.md

Author

Søren O’Neill

Published

January 10, 2024

1 Kommentér dit projekt

Lav og vedligehold en README.md fil i hvert projekt, på rod niveau (altså øverste folder niveau i projektet)

  • En simpel beskrivelse af projektets formål (besvar ‘hvorfor’)
  • Involverede personer
  • Data kilder mm.
  • Vigtigste komponenter (data og filer)

Det er særligt vigtigt for større og mere komplekse projekter med flere data kilder, flere samarbejdspartnere, etc

1.1 README.md template

#| eval: false
#| echo: true
# Project title

A subtitle that describes your project, e.g., research question

## Motivation

Motivate your research question or business problem. Clearly explain which problem is solved.

## Method and results

First, introduce and motivate your chosen method, and explain how it contributes to solving the research 
question/business problem.

Second, summarize your results concisely. Make use of subheaders where appropriate.


## Repository overview

Provide an overview of the directory structure and files, for example:

├── README.md
├── data
│   ├── my_data.csv  # raw data from CPR register
│   ├── exp_data.csv # experimental data register
├── plots
│   ├── plot_1.png   # Boxplot of age
│   ├── plot_2.png   # Pi chart of sex
│   └── plot_3.png   # Bi-plot age vs measurement X
├── main.R           # all analyses in one place
└── manuscript1.Rmd  # for J of RR

## Running instructions

Explain to potential users how to run/replicate your workflow. If necessary, touch upon the required input 
data, which secret credentials are required (and how to obtain them), which software tools are needed 
to run the workflow (including links to the installation instructions), and how to run the workflow.

## More resources

Point interested users to any related literature and/or documentation.

## About

Explain who has contributed to the repository.