updating yml file

.gitignore

@@ -0,0 +1 @@
+site/

mkdocs.yml

@@ -5,8 +5,7 @@ plugins:
 docs_dir: 'src'
 use_directory_urls: false 
 nav:
-    - About: index.md
-    - Specification:
+    - The BIDS Specification:
       - Introduction: 01-introduction.md
       - Common principles: 02-common-principles.md
       - Modality agnostic files: 03-modality-agnostic-files.md
@@ -16,4 +15,5 @@ nav:
         - Task events: 04-modality-specific-files/03-task-events.md
         - Physiological and other continous recordings: 04-modality-specific-files/04-physiological-and-other-continous-recordings.md
         - Behavioral experiments (with no MRI): 04-modality-specific-files/05-behavioural-experiments.md
-      - Longitudinal and multi-site studies: 05-longitudinal-and-multi-site-studies.md
+      - Longitudinal and multi-site studies: 05-longitudinal-and-multi-site-studies.md
+    - The BIDS Starter Kit: https://github.com/bids-standard/bids-starter-kit

readthedocs.yml

@@ -1,11 +1,5 @@
-# .readthedocs.yml
-
 build:
   image: latest
 
 python:
   version: 3.6
-
-formats:
-    - epub
-    - pdf

src/index.md

@@ -1,4 +1,9 @@
-# Brain Imaging Data Structure
+# The Brain Imaging Data Structure
 
-Placeholder for the instroduction to the project. Mkdocs requires an index.md
-file which becomes the landing page.
+This site serves as an online resource to see the current state of the
+Brain Imaging Data Structure (BIDS) specification. It contains information
+about the core specification, as well as many modality-specific extensions.
+
+To get started, [check out the introduction](01-introduction). If you'd like
+more information on how to adapt your own datasets to match the BIDS
+specification, we recommend exploring the [bids-specification starter kit](https://github.com/bids-standard/bids-starter-kit).