Merge branch 'pr-22'

Author: lee2sman

docs/assets/tutorials/install/mac2.webp

@@ -48,5 +48,5 @@ After downloading, extract the ZIP and serve the folder with a local web server.
 
 ## Running your programs
 
-To get started running L5 check out [Getting Started](/getting-started) or the [tutorials](index.md) to learn more.
+To get started running L5 check out [Getting Started](/getting-started) or the [tutorials](/tutorials/) to learn more.
 

docs/assets/tutorials/install/mac4.webp

@@ -68,7 +68,7 @@ love .
 ```
 
 It should now launch and you should see a new window open with your code sketch running.
-![A yellow background window appearing on top of folder holding L5 Starter and love application](/assets/tutorials/install/linux1.webp "A yellow background window appearing on top of folder holding L5 Starter and love application")
+<img src="/assets/tutorials/install/linux1.webp" alt="A yellow background window appearing on top of folder holding L5 Starter and love application" title="A yellow background window appearing on top of folder holding L5 Starter and love application" width="600" />
 
-**Next steps:** You've installed Love and have L5 on your computer and verified you can run your own programs. Check out [Getting Started](/getting-started) or the [tutorials](index.md) to learn more.
+**Next steps:** You've installed Love and have L5 on your computer and verified you can run your own programs. Check out [Getting Started](/getting-started) or the [tutorials](/tutorials/) to learn more.
 

docs/assets/tutorials/install/mac8.webp

@@ -11,7 +11,7 @@ This tutorial walks you through installing L5 with the Love (Love2d) framework o
 1. Love is the underlying Framework that will allow L5 code to run on your computer. So we start by installing Love. Go to the [Love website](https://love2d.org) and click to download the 64-bit zipped Mac program.
 ![Love2d website with downloads](/assets/tutorials/install/mac1.webp "Love2d website with downloads")
 2. Click **"Allow"** if it asks 'Do you want to allow downloads on "love2d.org"?' It should download to your *Downloads* folder by default.
-![Alert box asking permission to download Love2d](/assets/tutorials/install/mac2.webp "Alert box asking permission to install Love2d")
+![Alert box asking permission to download Love2d](/assets/tutorials/install/mac2test.webp "Alert box asking permission to install Love2d")
 3. Now on your desktop (called "Finder" on macOS) open up your *Downloads* folder. You can right click and choose Open (see screenshot) or double click on Love to launch it. 
 ![Folder with love application and L5 Starter folder](/assets/tutorials/install/mac3.webp "Folder with love application and L5 Starter folder")
 4. A warning popup box opens to say the program and code is not verified by Apple since you will be writing your own custom code. If you can choose Open because you turned off restrictions, then choose Open! Otherwise, **DO NOT** move to the trash. 
@@ -23,7 +23,7 @@ This tutorial walks you through installing L5 with the Love (Love2d) framework o
 7. From the L5lua.org Download page, [download the L5 Starter project](/L5-starter.zip).
 ![L5 website download page with L5 Starter](/assets/tutorials/install/mac7.webp "L5 website download page with L5 Starter")
 8. Click **"Allow"** if it asks 'Do you want to allow downloads on "l5lua.org"?'
-![Alert box asking permission to download L5-Starter](/assets/tutorials/install/mac8.webp "Alert box asking permission to download L5 Starter")
+![Alert box asking permission to download L5-Starter](/assets/tutorials/install/mac8test.webp "Alert box asking permission to download L5 Starter")
 9. Back in your downloads folder, **drag the L5-starter folder onto the Love application in the folder**. It should now launch and you should see a new window open with your code sketch.
 ![A yellow background window appearing on top of folder holding L5 Starter and love application](/assets/tutorials/install/mac9.webp "A yellow background window appearing on top of folder holding L5 Starter and love application")
 

docs/assets/tutorials/install/mac9.webp

@@ -11,4 +11,4 @@ This tutorial walks you through installing L5 with the Love (Love2d) framework o
 7. You should see a window open with a flying bird-shaped balloon and clouds, verifying that Love is now properly installed on your computer. **At this point you can close the window.**
 8. Back in your downloads folder, **extract the L5-starter.zip file** the same way you extracted the Love zip file. Then **drag the L5-starter folder onto the love.exe application**. It should now launch and you should see a new window open with your code sketch.
 
-**Next steps:** You've installed Love and have L5 on your computer and verified you can run your own programs. Check out [Getting Started](/getting-started) or the [tutorials](index.md) to learn more.
+**Next steps:** You've installed Love and have L5 on your computer and verified you can run your own programs. Check out [Getting Started](/getting-started) or the [tutorials](/tutorials/) to learn more.

docs/download/index.md

@@ -32,6 +32,10 @@ function mousePressed()
 end
 ```
 
+## How L5 Works
+
+L5 is a Lua library. Your L5 code runs inside **[Love2D](https://www.love2d.org/)**, a free open-source game framework. Think of Love2D as the engine and L5 as the creative coding toolkit on top. You download both: Love2D to run programs, and L5 to write them using a Processing-style API.
+
 ## Overview
 
 L5 brings the familiar Processing creative coding environment to Lua, offering some of the best aspects of both Processing and p5.js with some twists of its own. But you don't need to know Processing already to get started with L5. L5 is built on top of the Love2D framework, and offers near-instant loading times and excellent performance while maintaining the intuitive API that makes [Processing](https://processing.org/) accessible to artists and designers. *L5 is not an official implementation of Processing or the Processing Foundation. It is a community-created project.*