Hopefully fix hierarchy of definitions. Add .bsp to gitignore

Author: reidspencer

.gitignore

@@ -1,4 +1,5 @@
-/.idea
+/.idea/
+/.bsp/
 /project/project/
 /project/target/
 /target/

docs/riddl/concepts/index.md

@@ -4,8 +4,7 @@ title: "Overview"
 
 # Overview 
 In this section we will explore the concepts and ideas that RIDDL uses. This is
-not about the RIDDL language syntax, but about the concepts that the
-language uses and how they relate to each other.
+not about the RIDDL language syntax, just the concepts of the language.
 
 ## Definitions
 RIDDL consists only of [definitions](definition.md) that define the design of the desired system.  
@@ -36,62 +35,63 @@ easier to comprehend, we've taken some short-cuts :
 
 ### Hierarchy
 With those clarifying simplifications, here's the hierarchy:
-* [Root](root.md)
-  * [Domain](domain.md)
-    * [Type](type.md)
-    * [Epic](epic.md)
-      * [Case](case.md)
-        * [Statement](statement.md)
-    * [Context](context.md)
-      * [Type](type.md)
-      * [Group](element.md#group)
-        * [Output](output.md)
-        * [Input](input.md)
-      * [Entity](entity.md)
-        * [Type](type.md)
-        * [Function](function.md)
-          * [Statement](statement.md)
-        * [State](state.md)
-          * [Type](type.md)
-          * [Field](field.md)
-          * [Handler](handler.md)
-            * [On Clause](onclause.md)
-              * [Statement](statement.md)
-        * [Invariant](invariant.md)
-          * [Conditional](conditional.md)
-        * [Handler](handler.md)
-          * [On Clause](onclause.md)
-            * [Statement](statement.md)
-      * [Handler](handler.md)
-        * [On Clause](onclause.md)
-          * [Statement](statement.md)
-      * [Projector](projector.md)
-        * [Type](type.md)
-        * [Field](field.md)
-        * [Handler](handler.md)
-          * [On Clause](onclause.md)
-            * [Statement](statement.md)
-      * [Saga](saga.md)
-        * [Type](type.md)
-        * [SagaStep](sagastep.md)
-          * [Statement](statement.md)
-      * [Adaptor](adaptor.md)
-        * [Type](type.md)
-        * [Handler](handler.md)
-          * [On Clause](onclause.md)
-            * [Statement](statement.md)
-      * [Processor](processor.md)
-        * [Type](type.md)
-        * [Inlet](inlet.md) 
-        * [Outlet](outlet.md)
-        * [Statement](statement.md)
-      * [Function](function.md)
-        * [Statement](statement.md)
-      * [Streamlet](streamlet.md)
-        * [Type](type.md)
-        * [Inlet](inlet.md)
-        * [Outlet](outlet.md)
-        * [Connector](connector.md)
+
+1. [Root](root.md)
+  1. [Domain](domain.md)
+    1. [Type](type.md)
+    2. [Epic](epic.md)
+      1. [Case](case.md)
+        1. [Statement](statement.md)
+    3. [Context](context.md)
+      1. [Type](type.md)
+      2. [Group](element.md#group)
+        1. [Output](output.md)
+        2. [Input](input.md)
+      3. [Entity](entity.md)
+        1. [Type](type.md)
+        2. [Function](function.md)
+          1. [Statement](statement.md)
+        3. [State](state.md)
+          1. [Type](type.md)
+          2. [Field](field.md)
+          3. [Handler](handler.md)
+            1. [On Clause](onclause.md)
+              1. [Statement](statement.md)
+        4. [Invariant](invariant.md)
+          1. [Conditional](conditional.md)
+        5. [Handler](handler.md)
+          1. [On Clause](onclause.md)
+            1. [Statement](statement.md)
+      4. [Handler](handler.md)
+        1. [On Clause](onclause.md)
+          1. [Statement](statement.md)
+      5. [Projector](projector.md)
+        1. [Type](type.md)
+        2. [Field](field.md)
+        3. [Handler](handler.md)
+          1. [On Clause](onclause.md)
+            1. [Statement](statement.md)
+      6. [Saga](saga.md)
+        1. [Type](type.md)
+        2. [SagaStep](sagastep.md)
+          1. [Statement](statement.md)
+      7. [Adaptor](adaptor.md)
+        1. [Type](type.md)
+        2. [Handler](handler.md)
+          1. [On Clause](onclause.md)
+            1. [Statement](statement.md)
+      8. [Processor](processor.md)
+        1. [Type](type.md)
+        2. [Inlet](inlet.md) 
+        3. [Outlet](outlet.md)
+        4. [Statement](statement.md)
+      9. [Function](function.md)
+        2. [Statement](statement.md)
+      10 [Streamlet](streamlet.md)
+        1. [Type](type.md)
+        2. [Inlet](inlet.md)
+        3. [Outlet](outlet.md)
+        4. [Connector](connector.md)
 
 ## Next
 When you're done exploring all the concepts, check out our