From 5e8e0dffef6d3af97c35464d5e4e16317ac2e273 Mon Sep 17 00:00:00 2001 From: "Maryann E. Martone" Date: Thu, 2 Jan 2025 09:11:04 -0800 Subject: [PATCH] Update in-practice.md Added link and some formatting Added a link to the ReproNim statistics training module and also bolded the principles and actions. I still can't figure out how to get the Markdown style code from displaying on the top of the webpage. --- content/about/in-practice.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/content/about/in-practice.md b/content/about/in-practice.md index 62a48da..d7328dc 100644 --- a/content/about/in-practice.md +++ b/content/about/in-practice.md @@ -21,9 +21,9 @@ references to them (by NUMBER.LETTER) on other pages. -1. Study planning +1. **Study planning** - 1. Implement good science basics (power analysis, statistical consults, etc.). + 1. Implement good science basics ([power analysis, statistical consults, etc.](https://www.repronim.org/module-stats/)). 2. Use pre-existing data for planning and/or analysis. @@ -34,7 +34,7 @@ references to them (by NUMBER.LETTER) on other pages. 5. [Pre-register](https://www.cos.io/initiatives/prereg) your study. -2. Data and metadata management +2. **Data and metadata management** 1. Use standard data formats and extend them to meet your needs. @@ -43,7 +43,7 @@ references to them (by NUMBER.LETTER) on other pages. 3. Annotate data using standard, reproducible procedures. -3. Software management +3. **Software management** 1. Use released versions of open source software. @@ -58,7 +58,7 @@ references to them (by NUMBER.LETTER) on other pages. 6. Use containers where reasonable. -4. Publishing everything (publishing re-executable publications) +4. **Publishing everything** (publishing re-executable publications) 1. Share plans (pre-registration). @@ -72,15 +72,15 @@ references to them (by NUMBER.LETTER) on other pages. As indicated by the blue highlights in the figure below, four core actions are key to implementing the above principles. -1. Use of standards. +1. **Use of standards** - Using standard data formats and extending them to meet specific research needs is important for data and metadata management (Principle 2) in reproducible neuroimaging. + Using standard data formats and extending them to meet specific research needs is important for data and metadata management (Principle 2) in reproducible neuroimaging. -2. Annotation and provenance. +3. **Annotation and provenance** Annotating data using standard, reproducible procedures ensures clarity and transparency in data management (Principle 2). _Provenance_ refers to the origin and history of data and processes, enabling researchers to track how data was generated, modified, and analyzed (Principles 2, 3, and 4). This is essential for understanding the context of data and ensuring reproducibility. -3. Implementation of version control. +4. **Implementation of version control** Version control is crucial for both data and software management. It allows researchers to track changes over time, revert to previous versions if necessary, and collaborate effectively. @@ -90,7 +90,7 @@ As indicated by the blue highlights in the figure below, four core actions are k And even publications can be versioned (Principle 4). -4. Use of containers. +5. **Use of containers** Containers provide a portable and self-contained environment for running software, ensuring that the analysis can be executed consistently across different computing environments (Principle 3). Containers encapsulate all of the software dependencies needed to run an analysis, making it easier to share software (Principle 4) and reproduce results.