|
|
@@ -1,30 +1,29 @@
|
|
|
-# how to use this template
|
|
|
+# How to use this template
|
|
|
|
|
|
## Origin
|
|
|
|
|
|
-This project provides a template structure for research projects within the CRC/TRR 135 according to the results of a joint work with CRC 1158 and CRC 1315 (see https://genr.eu/wp/towards-a-standardized-research-folder-structure/) for details.
|
|
|
+This project provides a template structure for research projects within the CRC/TRR 135 according to the results of a joint work with CRC 1158 and CRC 1315 (see <https://genr.eu/wp/towards-a-standardized-research-folder-structure/> for details).
|
|
|
|
|
|
-Check https://github.com/tonic-team/Tonic-Research-Project-Template if you want to use your own.
|
|
|
+Check <https://github.com/tonic-team/Tonic-Research-Project-Template> if you want to use your own.
|
|
|
|
|
|
## License
|
|
|
|
|
|
By default, we added a CC-BY license to the repository, meaning anyone who can access this can reuse it anywhere, as long as he is mentioning the original work. You may want to delete it for now, and put it back (or another license) when you are ready to share this repository.
|
|
|
|
|
|
-## Easier Collatoration
|
|
|
+## Easier Collaboration
|
|
|
|
|
|
- Make sure every collaborator got to understand what files to find where.
|
|
|
-- This template was meant to be used in a git based workflow. This would allow you to collaborate using issues and pull request.
|
|
|
+- This template was meant to be used in a git based workflow. This would allow you to collaborate using issues and pull requests.
|
|
|
- The use of git submodule technology may help you share and publish only part of this repository.
|
|
|
|
|
|
Refer to XXX for further information.
|
|
|
|
|
|
+## Cheat sheet about what goes where:
|
|
|
|
|
|
-## Cheatsheets about what goes where:
|
|
|
-
|
|
|
-- Prior to data acquisition:
|
|
|
+- Prior to data acquisition
|
|
|
- save all documents related to research planning in the 01-Project_management folder, and update material and methods information as soon as possible. For instance, indicate all information about reagents at the time or purchase. And put any code or variable files created for data acquisition in the 02_material_methods folder.
|
|
|
|
|
|
-- Data acquisition and analysis:
|
|
|
+- Data acquisition and analysis
|
|
|
- Data is organised first following experiments, make sure to describe every experiment in a readme file and link to the adequate files saved in 02_material_methods.
|
|
|
- All files coming directly from your hardware should go in the rawdata folder.
|
|
|
- Any file that you want to archive or publish should go in the derivateddata folder. This includes results from manual analysis of the raw data.
|
|
|
@@ -33,28 +32,26 @@ Refer to XXX for further information.
|
|
|
- The output of your analysis (figures, and reproducible reports -pdfs-) should be saved in the 05_figures or the 06_disseminations/01_report_conferences/01_textreports folders, to facilitates sharing with non-coders.
|
|
|
|
|
|
- Manuscript preparation
|
|
|
- - Put figures ready for publication in the 05_figures/shared_figures folder
|
|
|
+ - Put figures ready for publication in the 05_figures/shared_figures folder.
|
|
|
- Put the manuscript (or some important versions of it, if using an external tool for writing it) in the 06_disseminations/02_manuscripts folder. You may want to use full URL to embed figures in the manuscript if the repository is open.
|
|
|
-
|
|
|
|
|
|
|
|
|
|
|
|
-# How to create a new study
|
|
|
+## How to create a new study
|
|
|
|
|
|
-`note: We have some forks of this repository made for specific communities with additional information.`
|
|
|
|
|
|
-## Github
|
|
|
+### Github
|
|
|
|
|
|
Creating a new study project according to the tonic template is really easy: Just use the button `Use this template`, specify the owner, name and privacy and select button `Create repository from template`. Here we go!
|
|
|
|
|
|
-## GIN, GOGS
|
|
|
+### GIN, GOGS
|
|
|
|
|
|
Click the create new repository button on GIN, choose import repository and use `https://github.com/tonic-team/Tonic-Research-Project-Template` as the clone address
|
|
|
|
|
|
-## Tonic
|
|
|
+### Tonic
|
|
|
|
|
|
Yet to come !
|
|
|
|
|
|
-# Notes
|
|
|
+## Notes
|
|
|
|
|
|
-We have some forks of this repository made for specific communities with additional information.
|
|
|
+We have some forks of this repository made for specific communities with additional information.
|
