add section about updated folder structure

diff --git a/README.md b/README.md
index adb59664d43a623432377a86916487ec52849881..770181981de6b5557e5ba15777aabd702370de91 100644 (file)
--- a/README.md
+++ b/README.md
@@ -18,10 +18,17 @@ the following resources are a great place to start:
 
 ## Folder structure
 
-The files in the root directory are for `.gitignore` templates that are
-project-specific, such as language or framework specific templates.
-Global (operating system or editor specific) templates should go into the
-[`Global/`](./Global) directory.
+We support a collection of templates, organized in this way:
+
+- [`Global`](./Global) contains templates for various editors, tools and
+  operating systems that can be used in different situations. It is recommended
+  that you either [add these to your global template](https://help.github.com/articles/ignoring-files/#create-a-global-gitignore)
+  or merge these rules into your project-specific templates if you want to use
+  them permanently.
+- [`ecosystem`](./ecosystem) contains specialized templates coalescing around
+  popular programming languages, but don't make sense to live in the mainstream
+  templates. These should be added to your project-specific templates when you
+  decide to adopt the framework or tool.
 
 ## Contributing guidelines