Second pass on documentation

Author: JasonAtClockwork

docs/docs/unreal/index.md

@@ -14,9 +14,7 @@ This tutorial assumes that you have a basic understanding of the Unreal Engine,
 
 We’ll keep things intentionally simple: a single “Game Manager” class, minimal error handling, and hardcoded settings where convenient. This makes the SDK flow easy to see. For production, prefer Unreal’s Subsystems, move secrets out of code, follow best practices, and add proper logging/retry.
 
-SpacetimeDB supports Unreal Engine version `5.6` or later, and this tutorial has been tested with the following Unreal versions:
-- `5.6`
-> REVIEW: We should be able to support 5.3+ as C++20 became the default + minimum; however current build has been on 5.6; do we want to look into earlier versions of UE, not everyone jumps on the latest for stability reasons?
+SpacetimeDB supports Unreal Engine version `5.6`. This tutorial has been tested only with that version.
 
 This tutorial is written for C++, but the SpacetimeDB Unreal client SDK also supports Blueprints! Stay tuned for a Blueprint-based tutorial.
 

docs/docs/unreal/part-1.md

@@ -28,15 +28,16 @@ In this section, we will guide you through the process of setting up a Unreal Pr
 
 ### Step 1: Create a Blank Unreal Project
 
-SpacetimeDB supports Unreal version `5.6` or later. See [the overview](.) for more information on specific supported versions.
+SpacetimeDB supports Unreal version `5.6`. See [the overview](.) for more information on specific supported versions.
 
 Launch Unreal 5.6 and create a new project by selecting Games from the Unreal Project Browser.
 
-> ⚠️ Important: Select the **Blank** template and in **Project Defaults** select **C++**. 
+> ⚠️ Important: Select the **Blank** template and in **Project Defaults** select **C++**.
 
-For `Project Name` use `client_unreal`. For Project Location make sure that you use your `blackholio` directory. This is the directory that we created in a previous step.
+For **Project Name** use `client_unreal`.
+For **Project Location**, use your `blackholio` directory (created in the previous step).
 
-Click "Create" to generate the blank project.
+Click **Create** to generate the blank project.
 
 ![Create Blank Project](./part-1-01-create-project.png)
 
@@ -48,8 +49,6 @@ While the SpacetimeDB Unreal client SDK is in preview releases, it can only be i
 
 Once the SDK is stabilized, we'll find a more ergonomic way to distribute it.
 
-> REVIEW: We need to decide how we'll share the SDK (eventually we should host with Fab.com and they can add it like any normal Unreal plugin)
-
 Before beginning make sure to close the Unreal project and IDE.
 
 Add the SpacetimeDB Unreal SDK by first adding a new plugin folder:
@@ -59,75 +58,74 @@ md Plugins
 ```
 Copy the SpacetimeDbSdk to the new Plugins folder. This should create `/client_unreal/Plugins/SpacetimeDbSdk`.
 
-In the root of the Unreal project, right click the client_unreal.uproject and select **Generate Visual Studio project files**. 
+In the root of the Unreal project, right click the client_unreal.uproject and select **Generate Visual Studio project files**.
 
 ![Generate project files](./part-1-02-generate-project.png)
 
 ### Create the GameManager Actor
 
-1. Open the `client_unreal` project. Unreal will prompt you to build the `SpacetimeDbSdk` module. Do so.
-2. Open **Tools > New C++ Class** in the top menu, select **Actor** as the parent and click **Next**
+1. Open the `client_unreal` project. Unreal will prompt you to build the `SpacetimeDbSdk` plugin. Do so.
+2. Open **Tools -> New C++ Class** in the top menu, select **Actor** as the parent and click **Next**
 3. Select **Public** Class Type
-4. Name the script `GameManager`.
-
-The `GameManager` script will be where we will put the high level initialization and coordination logic for our game.
+4. Name the class `GameManager`.
 
-> Typically with Unreal you would use a Subsystem for this but to keep the tutorial simple we'll stick with a singleton actor.
+The `GameManager` class will be where we will put the high level initialization and coordination logic for our game.
 
-### Setup the Level
+> Note: In a production Unreal project, you would typically implement this logic in a Subsystem. For simplicity, this tutorial uses a singleton actor.
 
-Let's set up the basic level, add our new GameManager to the level and a little lighting cleanup for our 2D setup.
+### Set Up the Level
 
-1. **Create a new Level**:
-   - Open `File > New Level` in the top menu, and select Empty Level and click **Create**.
-   - Save the level and name it `Blackholio`
+Set up the basic level, add the new `GameManager` to the level, and add lighting.
 
-2. **Create GameManager Blueprint**:
-   - In the **Content Drawer**, click **Add**, select `Blueprint > Blueprint Class`
-   - Expand **All Classes**, search for `GameManager`, highlight it, and click **Select**
-   - Name the blueprint `BP_GameManager`
+1. **Create a new level**  
+   - Open **File -> New Level** in the top menu, select **Empty Level**, and click **Create**.  
+   - Save the level and name it `Blackholio`.
 
-3. **Update Maps & Modes**:
-   - Open `Edit > Project Settings` in the top menu, select `Project > Maps & Modes` on the left.
-   - Update **Editor Startup Map** to the new `Blackholio` map
-   - Update **Game Default Map** to the new `Blackholio` map
+2. **Create a GameManager Blueprint**  
+   - In the **Content Drawer**, click **Add**, then select **Blueprint -> Blueprint Class**.  
+   - Expand **All Classes**, search for **GameManager**, highlight it, and click **Select**.  
+   - Name the blueprint `BP_GameManager`.
 
-![Pick Parent Class](./part-1-03-create-blueprint.png)
+3. **Update Maps & Modes**  
+   - Open **Edit -> Project Settings** in the top menu, then select **Project -> Maps & Modes** on the left.  
+   - Set **Editor Startup Map** to `Blackholio`.  
+   - Set **Game Default Map** to `Blackholio`.
+   ![Pick Parent Class](./part-1-03-create-blueprint.png)
 
-4. **Add to the Level**:
-   - Drag and drop the `BP_GameManager` blueprint from the **Content Drawer** window into the scene view.
+4. **Add to the Level**  
+   - Drag the `BP_GameManager` blueprint from the **Content Drawer** into the scene view.
 
-5. **Add a Directional Light**:
-   - Click the **Add** button in the top toolbar, and select `Lights > Directional Light`
-   - Update `Rotation` to -105.0, -31.0, -14.0
+5. **Add a Directional Light**  
+   - Click **Add** in the top toolbar, then select **Lights -> Directional Light**.  
+   - Set **Rotation** to -105.0, -31.0, -14.0.
 
-6. **Add a PostProcessVolume**:
-   - Click the **Add** button in the top toolbar, and select `Volumes > Post Process Volume`
-   - Enable and update `Exposure > Exposure Compensation` to 0.0
-   - Enable and update `Exposure > Min EV100` to 1.0
-   - Enable and update `Exposure > Max EV100` to 1.0
-   - Enable `Post Process Volume Settings > Infinite Extend (Unbounded)`
+6. **Add a Post Process Volume**  
+   - Click **Add** in the top toolbar, then select **Volumes -> Post Process Volume**.  
+   - Enable and set **Exposure -> Exposure Compensation** to 0.0.  
+   - Enable and set **Exposure -> Min EV100** to 1.0.  
+   - Enable and set **Exposure -> Max EV100** to 1.0.  
+   - Enable **Post Process Volume Settings -> Infinite Extend (Unbounded)**.
 
-### Add simple GameMode
+### Add a Simple GameMode
 
-We'll need a very simple GameMode to tweak the start up settings. Let's add that now and wire it in for the World Settings.
+Create a simple GameMode to tweak the startup settings and connect it to the World Settings.
 
-1. **Create the C++ Class**:
-   - Open `Tools > New C++ Class` in the top menu, select **GameModeBase** as the parent and click **Next**
-   - Select **Public** Class Type
-   - Name the script `BlackholioGameMode`
+1. **Create the C++ class**  
+   - Open **Tools -> New C++ Class** in the top menu, select **GameModeBase** as the parent, and click **Next**.  
+   - Select **Public** as the class type.  
+   - Name the class `BlackholioGameMode`.
 
-2. **Create GameMode Blueprint**:
-   - In the **Content Drawer**, click **Add**, select `Blueprint > Blueprint Class`
-   - Expand **All Classes**, search for `BlackholioGameMode`, highlight it, and click **Select**
-   - Name the blueprint `BP_BlackholioGameMode`
+2. **Create a GameMode Blueprint**  
+   - In the **Content Drawer**, click **Add**, then select **Blueprint -> Blueprint Class**.  
+   - Expand **All Classes**, search for `BlackholioGameMode`, highlight it, and click **Select**.  
+   - Name the blueprint `BP_BlackholioGameMode`.
 
-3. **Update WorldSettings**:
-   - Open `Window > World Settings` in the top menu
-   - Update GameMode Override from **None** to **BP_BlackholioGameMode**
-   - Save the level
+3. **Update World Settings**  
+   - Open **Window -> World Settings** in the top menu.  
+   - Change **GameMode Override** from **None** to `BP_BlackholioGameMode`.  
+   - Save the level.
 
-The foundation for our Unreal project is all set up! If you press play, it will show a blank screen, but it should start the game without any errors. Now we're ready to get started on our SpacetimeDB server module, so we have something to connect to!
+At this point, the foundation of the Unreal project is set up. Pressing Play will show a blank screen, but the game should start without errors. Next, we’ll create the SpacetimeDB server module so we have something to connect to.
 
 ### Create the Server Module
 

docs/docs/unreal/part-2.md

@@ -467,7 +467,7 @@ This will also generate a file in the `client_unreal/Source/client_unreal/Privat
 
 ### Connecting to the Database
 
-To make sure building the Unreal project will work, let's make sure to update the `client_unreal.Build.cs` to include the SpacetimeDbSdk. Update the PublicDependencyModuleNames, and PrivateDependencyModuleNames as following for current and future needs:
+Update `client_unreal.Build.cs` to include the `SpacetimeDbSdk`. Add `SpacetimeDbSdk` to `PublicDependencyModuleNames`, and confirm that `PrivateDependencyModuleNames` includes the following modules for current and future needs:
 
 ```cpp
         PublicDependencyModuleNames.AddRange(new string[]
@@ -489,7 +489,8 @@ To make sure building the Unreal project will work, let's make sure to update th
         });
 ```
 
-At this point we can set up Unreal to connect your Unreal client to the server. We'll need to update the `GameManager.h` to the following:
+Update `GameManager.h` as follows to set up the Unreal client connection to the server:
+
 ```cpp
 #pragma once
 
@@ -505,7 +506,7 @@ class CLIENT_UNREAL_API AGameManager : public AActor
 {
     GENERATED_BODY()
 
-public:	
+public:
     AGameManager();
     static AGameManager* Instance;
 
@@ -553,11 +554,11 @@ private:
     UFUNCTION()
     void HandleDisconnect(UDbConnection* InConn, const FString& Error);
     UFUNCTION()
-    void HandleSubscriptionApplied(FSubscriptionEventContext& Context);	
+    void HandleSubscriptionApplied(FSubscriptionEventContext& Context);
 };
 ```
 
-Next up let's update the `GameManager.cpp` to finalize the setup:
+Next, update GameManager.cpp to finalize the setup:
 
 ```cpp
 #include "GameManager.h"