created readme file based on old tf2.3 version

Author: oscarjalnefjord

README.md

@@ -1 +1,33 @@
-# TF2.4_IVIM_code_collection
+# TF2.4_IVIM_code_collection
+
+The ISMRM Open Science Initiative for Perfusion Imaging (OSIPI) is an initiative of the ISMRM Perfusion Study Group, founded in 2019 after a membership survey, and with a mission to: 
+
+>“promote the sharing of perfusion imaging software in order to eliminate the practice of duplicate development, improve the reproducibility of perfusion imaging research, and speed up the translation into tools for discovery science, drug development, and clinical practice”
+
+This **IVIM code collection** code library is maintained by OSIPI [Taskforce 2.4](https://www.osipi.org/task-force-2-4/) (*currently not available*) and aims to collect, test and share open-source code related to intravoxel incoherent motion (IVIM) analysis of diffusion encoded MRI data to be used in research and software development. Code contributions can include any code related IVIM analysis (denoising, motion correction, model fitting, etc.), but at an initial phase, development of tests and other features of the repository will predominantly focus on fitting algorithms. A future goal of the IVIM OSIPI task force is to develop a fully tested and harmonized code library, building upon the contributions obtained through this initiative.
+
+## How to contibute
+
+If you would like to get involve in OSIPI and work within the task force, please email the contacts listed on our website.
+
+If you would like to contribute with code, please follow the instructions below:
+
+*   [Setting up Git](doc/setting_up_git.md)
+*   [How to create a copy of the respository and contribute changes to the repository](doc/create_local_copy_of_repository.md)
+*   [Guidelines for code contribution](doc/guidelines_for_contributions.md)
+*   [Guidelines to creating a test file](doc/creating_test.md) 
+
+## Repository Organization
+
+The repository is organized in four main folders along with configuration files for automated testing. 
+
+The **doc** folder contains all documentation related to the repository of task force 2.4.
+
+The **src** folder contains source code contributed by the the community. Within **src**, the **original** folder contains the code to be tested, and the **wrappers** folder contains code for harmizing the calls the different code contributions. Within the **original** folders, contributions are stored in Initials_InstitutionCountry, e.g. src/original/OGC_AmsterdamUMC.
+
+The **test** folder contains the test files corresponding to the contributed code in **src**. *to be structured*
+
+The **utils** folder contains various helpful tools.
+
+## View Testing Reports
+*to be added*

doc/create_local_copy_of_repository.md

@@ -0,0 +1,9 @@
+# How to create a copy of the repository and contribute changes
+
+The instructions outlined below shows a few (but far from all) ways for creating a copy of the repository and contribute with changes.
+
+# Using Visual Studio Code
+*to be added*
+
+# Alternative approach
+*to be added*

doc/creating_test.md

@@ -0,0 +1,3 @@
+# Guidelines for creating test files
+
+*to be added*

doc/guidelines_for_contributions.md

@@ -0,0 +1,10 @@
+# Guidelines for code contribution
+
+## Contributor Information
+*to be added*
+
+## Source code format
+*to be added*
+
+## How to submit
+*to be added*

doc/setting_up_git.md

@@ -0,0 +1,2 @@
+## Installing Git
+To install a fresh copy of Git or to upgrade to the latest version, please follow the instructions outlined in: [Installing Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)