From ce2add52a8b189c2b22cb675d4ae66512f8a80bb Mon Sep 17 00:00:00 2001 From: julien colomb Date: Tue, 21 Feb 2023 10:13:53 +0100 Subject: [PATCH 1/2] Changes including feedback from workshop SFB1315 --- 02_material_and_methods/README_MM.md | 11 +++++++++- 03_data/README_DATA_STORE.md | 25 +++++++++++++++++++++- README.md | 32 ++++++++++++++++++++-------- 3 files changed, 57 insertions(+), 11 deletions(-) diff --git a/02_material_and_methods/README_MM.md b/02_material_and_methods/README_MM.md index cd2fb9e..ceb9139 100644 --- a/02_material_and_methods/README_MM.md +++ b/02_material_and_methods/README_MM.md @@ -1,3 +1,12 @@ # Content -Please provide a summary of the content of this section and update it properly. \ No newline at end of file +## Hardware details + +For self-built hardware, it is recommended to have a special repository for its description and link it with a URL or as a submodule here. For any hardware, you should provide a user guide with the following information: + +- How to check the hardware is working: calibration, validation +- Troubleshooting guide, common issues +- What was bought were? +- What was custom-built, by whom and how ? +- Critical hardware parts, what could be modified? +- Schematics and/or photos (lots of photos) diff --git a/03_data/README_DATA_STORE.md b/03_data/README_DATA_STORE.md index cd2fb9e..1b5878f 100644 --- a/03_data/README_DATA_STORE.md +++ b/03_data/README_DATA_STORE.md @@ -1,3 +1,26 @@ # Content -Please provide a summary of the content of this section and update it properly. \ No newline at end of file +This readme contains a summary of information you should provide about your data. This is mostly meant as a checklist, as the information should be best included in the readme of the data folders or in the data management plan. It is advised to draw the data flow to keep an overview. + +# 001 + +## Hardware/tool used for acquisition + +## protocol + +- Standard procedure +- Glossary/definition of terms (for categorical variables) +- What changed, when and why +- Techniques that were tested but not chosen, and why + +## raw data description + +- how does good/reliable data look like +- exclusion criteria +- data flow. What type of data is collected when +- headers description, how to interpret the data + +## data analysis + +- analysis workflow +- code versions diff --git a/README.md b/README.md index 246f2a9..df3829a 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,11 @@ ## Abstract, vision and goals -## Milestones +## Project status + +### Roadmap and Milestones + +### Successes and failures ## Contributors @@ -10,19 +14,29 @@ [Mention your contributors either by including a contributors list here, or by referring to another file that lists your contributors, see documentation for options and examples. It is good practice to set roles for each contributor at the start of the project and discuss author byline of a future paper early.] -## List of experiments +## Experiments + +### 001 -## Direct links (inside or outside this repository) +FIX: short description, +details at [03_data/README_DATA_STORE](03_data/README_DATA_STORE) +and/or in the data management plan: [01_project_management/05_data_management_plans](01_project_management/05_data_management_plans). + +## Communication - todo list: [use issues](../../issues) -- data management plan: [01_project_management/05_data_management_plans](01_project_management/05_data_management_plans) -- Smartfigure tag: [YOURTAG](https://sdash.sourcedata.io/?q=YOURTAG) [FIXME:replace YOURTAG in the url and the text.] -- Main Communication channel: FIXME +- minutes: [01_project_management/03_meeting_minutes](01_project_management/03_meeting_minutes) +- Communication tools and email archive: -## Other information +## Outreach and external links + +- Smartfigure tag: [YOURTAG](https://sdash.sourcedata.io/?q=YOURTAG) [FIXME:replace YOURTAG in the url and the text.] -**Note:** This repository follows the Research repository template, v.2.3, see [further information offline](.doc/information.md) or [the online documentation page](https://gin-tonic.netlify.app/). ## Contribution -If you are new to this project, familiarise yourself with the vision, set your own role and responsibilities with the team, and read the data management plan. Make sure your contributions can be understood and reused by other members of the team. +If you are new to this project, get familiar with the vision, set your own role and responsibilities with the team, and read the data management plan. Make sure your contributions can be understood and reused by other members of the team. + +## Technical note + +**Note:** This repository follows the Research repository template, v.2.4, see [further information offline](.doc/information.md) or [the online documentation page](https://gin-tonic.netlify.app/). Do not modify folder name unless you are sure of what you are doing. \ No newline at end of file From 24d1ae9d622e92cc514da9e969184c5f2a1cb081 Mon Sep 17 00:00:00 2001 From: julien colomb Date: Tue, 21 Feb 2023 10:19:57 +0100 Subject: [PATCH 2/2] added information about changing folder names --- .doc/information.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.doc/information.md b/.doc/information.md index ba2bc1d..6f4a756 100644 --- a/.doc/information.md +++ b/.doc/information.md @@ -57,3 +57,7 @@ Yet to come ! ## Notes We have some forks of this repository made for specific communities with additional information. + +# Changing folder name + +It is advised not to change folder names, so it is kept a standard. Also some implementation of this standard uses submodules, and changing folder name there might break the synchronisation work (one needs to use specific git command to change submodule path). \ No newline at end of file