[ENH] summaries and intros - getting started section (#504)

* summaries and intros - getting started section * Update docs/getting_started/folders_and_files/index.md looks good Co-authored-by: Anthony Galassi <[email protected]> * Update docs/getting_started/folders_and_files/index.md thanks Co-authored-by: Remi Gau <[email protected]> * Update index.md added breaks and updated text. * Update talks.md break added * Update docs/getting_started/tutorials/index.md added breaks, cleaned up wording, added issue link for submitting new tutorials. Co-authored-by: christinerogers <[email protected]> * Update docs/getting_started/tutorials/conversion/index.md simplified and edited per suggestions Co-authored-by: christinerogers <[email protected]> * Update index.md updated per suggestions * Update index.md small wording edit --------- Co-authored-by: Anthony Galassi <[email protected]> Co-authored-by: Remi Gau <[email protected]> Co-authored-by: christinerogers <[email protected]>
bids-standard · Oct 10, 2024 · 878db72 · 878db72
1 parent 0806c6b
commit 878db72
Show file tree

Hide file tree

Showing 5 changed files with 21 additions and 2 deletions.
diff --git a/docs/getting_started/folders_and_files/index.md b/docs/getting_started/folders_and_files/index.md
@@ -1 +1,4 @@
-A BIDS dataset basically consists of a collection of folders and files.
+# BIDS Folders and Files
+
+A BIDS dataset consists of a collection of folders and files that are organized and named in compliance with the BIDS specification.
+The following sections provide more information on how to properly organize and name your data. 
diff --git a/docs/getting_started/resources/index.md b/docs/getting_started/resources/index.md
@@ -0,0 +1,7 @@
+# BIDS Resources
+
+The following collection of resources have been compiled to help you get started with BIDS. 
+The links section has links to software tools for working with BIDS datasets. 
+The glossary section has explanations of common BIDS "jargon".
+The dependencies section provides an overview of software and programming languages commonly used with BIDS.
+The talks and slides page has links to some recent presentations about using BIDS file organization and BIDS tools. 
diff --git a/docs/getting_started/resources/talks.md b/docs/getting_started/resources/talks.md
@@ -1,6 +1,7 @@
 # Talks and slides
 
-You can find curated list of talks and slides:
+BIDS-related talks and presentations are ongoing. 
+Two great resources for curated lists of talks and slides are:
 
 -   [on this project on OSF](https://osf.io/yn93h/)
 -   [organized by playlist on the BIDS youtube channel](https://www.youtube.com/channel/UCxZUcYfd_nvIVWAbzRB1tlw/playlists)

diff --git a/docs/getting_started/tutorials/conversion/index.md b/docs/getting_started/tutorials/conversion/index.md
@@ -0,0 +1,4 @@
+# BIDS Conversion
+
+We know that converting datasets to BIDS organization comes with some challenges, including file reorganization and renaming. 
+The following guides can help. 
diff --git a/docs/getting_started/tutorials/index.md b/docs/getting_started/tutorials/index.md
@@ -1,5 +1,9 @@
 # Tutorials
 
+Many BIDS tutorials have been created by the greater BIDS community and a selection are linked here. 
+We aim to add more high-quality tutorials to this list as new tutorials are created and the maintainers become aware of them. 
+Let us know about tutorials that are missing from this list by submitting a [request on github](https://github.com/bids-standard/bids-website/issues) to add them to this website.  
+
 ## Video tutorials
 
 Check out the