adding slides

Author: Brilator

CONTRIBUTING.md

@@ -19,7 +19,7 @@ This repo basically brings together slides and slide-decks (which themselves sou
 ├── README.md
 ├── scripts                # <- scripts to take care of build logic and pulling metadata from slides.md YAML frontmatter
 ├── slide-decks
-└── themes                 # <- themes for styling a slide deck
+└── themes                 # <- themes including layouts for styling a slide deck
 ```
 
 ### Adding a new slide deck
@@ -38,21 +38,53 @@ slide-decks/<NameOfSlideDeck>
 Note: Only slide decks **following exactly** this path and file name (`slides.md`) convention are automatically picked up.
 
 
-#### slides.md
+#### Adding slides
 
-To compile slides from other slides, use this logic
+There's two main ways to add slides
 
-```md
----
-src: path/to/slide
----
-```
+1. Adding it directly inside `slides.md`: 
+
+  ```markdown
+  ---
+  
+  # Header slide 1
+
+  Content slide 1
+
+  ---
+
+  # Header slide 2
+  
+  Content slide 2  
+  
+  ---
+
+  ```
+
+
+2. Compile slides from other slides, use this src logic:
+
+  ```md
+  ---
+  src: path/to/slide
+  ---
+  ```
+  
+  E.g.
+  
+  ```md
+  ---
+  src: ../../EduBricks-EduPaths/EduBricks/my-brick.md
+  ---
+  ```
 
-E.g.
+  You can also selectively add slides with the `#` logic at the end
 
----
-src: ../../EduBricks-EduPaths/EduBricks/my-brick.md
----
+  ```md
+  ---
+  src: ../../EduBricks-EduPaths/EduBricks/my-brick.md#1,2
+  ---
+  ```
 
 
 ## Breaking Links