-Ok to use for images and other assets
-
-Don't use for pages (the `.md` files) - GitHub doesn't support them properly (it flattens everything - this can cause collisions, plus there is no way to link from subdir to another subdir that works on both GitLab and GitHub)
-
- - Put all `.md` files in root
+It's ok (and preferred) to put images and other assets into subdirectories but we have to **put pages (the `.md` files) in root** becuase GitHub doesn't support subdirs properly (it flattens everything - this can cause collisions, plus there is no way to link from subdir to another subdir that works on both GitLab and GitHub).