summaries and intros - tools section

docs/tools/bids-apps.md

@@ -1 +1,5 @@
+# BIDS Apps
+
+BIDS Apps are typically docker or singularity images that allow you to seamlessly run many applications without the need to installing all dependencies, and are generally guaranteed to run on your data, provided your data is BIDS compliant. Below is a list of many commonly used BIDS Apps. 
+
 {{ MACROS___generate_apps_table() }}

docs/tools/converters/index.md

@@ -1 +1,3 @@
 # Converters
+
+The following list of converters is provided to help you convert your raw data into a BIDS compliant dataset. 

docs/tools/converters/meeg.md

@@ -1 +1,5 @@
+#MEEG
+The following list of converters can help you convert EEG, MEG, and iEEG data into BIDS compliant datasets. 
+
+
 {{ MACROS___generate_converter_table(file="MEEG_converters.yml") }}

docs/tools/converters/mri-pet.md

@@ -1 +1,4 @@
+#MRI and PET
+The following list of converters can help you convert MRI and PET data into BIDS compliant datasets. 
+
 {{ MACROS___generate_converter_table(file="converters.yml") }}

docs/tools/converters/others.md

@@ -1,3 +1,7 @@
+# Other converters
+
+The following tools can help you with miscelaneous tasks that may require you to convert to and from BIDS to work with certain, specific tools. These tools are very workflow specific and may not apply to the majority of projects. 
+
 {{ MACROS___generate_converter_table(file="from_BIDS_converters.yml") }}
 
 {{ MACROS___generate_converter_table(file="other_converters.yml") }}

docs/tools/converters/physio.md

@@ -1 +1,4 @@
+#Physio Data
+The following list of converters can help you convert physiological data into BIDS compliant datasets. 
+
 {{ MACROS___generate_converter_table(file="physio_converters.yml") }}

docs/tools/index.md

@@ -1,16 +1,13 @@
-# Tools
+# BIDS Tools
 
 There is a rich ecosystem of tools to help you work with BIDS datasets.
 
-There are many [converters](./converters/index.md)
+- Converters: There are many [converters](./converters/index.md)
 to help you go from your sourcedata to have a BIDS dataset.
-
-The [BIDS validator](./validator.md) is there to ensure that your BIDS dataset is valid.
-
-You can use the [BIDS apps](./bids-apps.md)
+- BIDS Validator: The [BIDS validator](./validator.md) is there to ensure that your BIDS dataset is valid and will work with BIDS Apps without any obvious issues. 
+- BIDS Apps: You can use [BIDS apps](./bids-apps.md)
 (automated pipelines that can be used as Docker or Apptainer images)
 to process your BIDS datasets.
-
-There are many other [tools](./others.md) to help you work with, edit or curate BIDS datasets.
+- Misc: There are many other [tools](./others.md) to help you work with, edit, or curate BIDS datasets.
 
 <meta property="og:title" content="Tools"/>