Update README;

README.md

@@ -3,7 +3,7 @@ lovr-docs
 
 This repository contains the documentation for [LÖVR](https://github.com/bjornbytes/lovr).
 
-There are three main types of documentation here:
+There are four main types of documentation here:
 
 - The **`api`** folder contains a Lua table with metadata for all LÖVR functions and objects.
   - This is used to generate documentation, but is also useful for integrating with other tools
@@ -11,12 +11,19 @@ There are three main types of documentation here:
   - Each function, object, etc. has a Lua file that exports its metadata.  These are aggregated
   into a single table stored in `init.lua`.  The aggregator is a LÖVR script, you can run it by
   typing `lovr api` at the root of this repository.
-- The **`examples`** folder contains sample LÖVR projects and tutorials.
+- The **`examples`** folder contains small LÖVR projects demonstrating a specific task/technique.
+  They aim to be minimal and easy to understand/copy.
   - The ones listed in the `init.lua` file are shown on the website.
-  - All the code in the examples is released under CC0.  However, the models, textures, sounds, and
-  other assets used may use different licensing, so be sure to double check those.
+- The **`showcase`** folder contains full LÖVR projects that implement entire games or demos.  The
+  code is less important for these and it is more about the end result.
+  - The ones listed in the `init.lua` file are shown on the website.
+  - Also, each showcase project may contain its own `init.lua` with metadata about the project.
+  Currently, this can contain an `author` table with `name` and `link` strings.
 - The **`guides`** folder contains markdown files that explain LÖVR-related concepts in depth.
   - Similarly, `init.lua` contains a manifest used to populate the sidebar on the website.
 
 Note that each release of LÖVR has its own branch.  Cherry picks are used to propagate fixes to
 relevant branches as needed.  Which will totally scale.
+
+All the code in the example/showcase projects is released under CC0.  However, the models, textures,
+sounds, and other assets used may use different licensing, so be sure to double check those.