Merge branch 'develop' into stable

8 files changed, 1073 insertions, 548 deletions

diff --git a/docs/README.md b/docs/README.md
index e4220de2..ddde6b09 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -19,11 +19,14 @@ doesn't change any of your game files. It serves eight main purposes:
    _SMAPI detects when a mod accesses part of the game that changed in a game update which affects
    many mods, and rewrites the mod so it's compatible._
 
-5. **Intercept errors.**  
-   _SMAPI intercepts errors that happen in the game, displays the error details in the console
-   window, and in most cases automatically recovers the game. This prevents mods from accidentally
-   crashing the game, and makes it possible to troubleshoot errors in the game itself that would
-   otherwise show a generic 'program has stopped working' type of message._
+5. **Intercept errors and automatically fix saves.**  
+   _SMAPI intercepts errors, shows the error info in the SMAPI console, and in most cases
+   automatically recovers the game. That prevents mods from crashing the game, and makes it
+   possible to troubleshoot errors in the game itself that would otherwise show a generic 'program
+   has stopped working' type of message._
+
+   _SMAPI also automatically fixes save data in some cases when a load would crash, e.g. due to a
+   custom location or NPC mod that was removed._
 
 6. **Provide update checks.**  
    _SMAPI automatically checks for new versions of your installed mods, and notifies you when any
@@ -38,16 +41,36 @@ doesn't change any of your game files. It serves eight main purposes:
    something goes wrong. (Via the bundled SaveBackup mod.)_
 
 ## Documentation
-Have questions? Come [chat on Discord](https://discord.gg/KCJHWhX) with SMAPI developers and other
-modders!
+Have questions? Come [ask the community](https://smapi.io/community) to get help from SMAPI
+developers and other modders!
 
 ### For players
 * [Player guide](https://stardewvalleywiki.com/Modding:Player_Guide)
 
 ### For modders
-* [Modding documentation](https://stardewvalleywiki.com/Modding:Index)
-* [Mod build configuration](mod-build-config.md)
+* [Modding documentation](https://smapi.io/docs)
+* [Mod build configuration](technical/mod-package.md)
 * [Release notes](release-notes.md)
 
 ### For SMAPI developers
-* [Technical docs](technical-docs.md)
+* [Technical docs](technical/smapi.md)
+
+## Translating SMAPI
+SMAPI rarely shows text in-game, so it only has a few translations. Contributions are welcome! See
+[Modding:Translations](https://stardewvalleywiki.com/Modding:Translations) on the wiki for help
+contributing translations.
+
+locale     | status
+---------- | :----------------
+default    | ✓ [fully translated](../src/SMAPI/i18n/default.json)
+Chinese    | ❑ not translated
+French     | ❑ not translated
+German     | ✓ [fully translated](../src/SMAPI/i18n/de.json)
+Hungarian  | ❑ not translated
+Italian    | ❑ not translated
+Japanese   | ❑ not translated
+Korean     | ❑ not translated
+Portuguese | ❑ not translated
+Russian    | ❑ not translated
+Spanish    | ❑ not translated
+Turkish    | ❑ not translated
diff --git a/docs/mod-build-config.md b/docs/mod-build-config.md
index a97c3171..4ec83e93 100644
--- a/docs/mod-build-config.md
+++ b/docs/mod-build-config.md
@@ -1,283 +1 @@
-The **mod build package** is an open-source NuGet package which automates the MSBuild configuration
-for SMAPI mods.
-
-The package...
-
-* detects your game install path;
-* adds the assembly references you need (with automatic support for Linux/Mac/Windows);
-* packages the mod into your `Mods` folder when you rebuild the code (configurable);
-* configures Visual Studio to enable debugging into the code when the game is running (_Windows only_);
-* adds C# analyzers to warn for Stardew Valley-specific issues.
-
-## Contents
-* [Install](#install)
-* [Configure](#configure)
-* [Code analysis warnings](#code-analysis-warnings)
-* [Troubleshoot](#troubleshoot)
-* [Release notes](#release-notes)
-
-## Install
-**When creating a new mod:**
-
-1. Create an empty library project.
-2. Reference the [`Pathoschild.Stardew.ModBuildConfig` NuGet package](https://www.nuget.org/packages/Pathoschild.Stardew.ModBuildConfig).
-3. [Write your code](https://stardewvalleywiki.com/Modding:Creating_a_SMAPI_mod).
-4. Compile on any platform.
-
-**When migrating an existing mod:**
-
-1. Remove any project references to `Microsoft.Xna.*`, `MonoGame`, Stardew Valley,
-   `StardewModdingAPI`, and `xTile`.
-2. Reference the [`Pathoschild.Stardew.ModBuildConfig` NuGet package](https://www.nuget.org/packages/Pathoschild.Stardew.ModBuildConfig).
-3. Compile on any platform.
-
-## Configure
-### Deploy files into the `Mods` folder
-By default, your mod will be copied into the game's `Mods` folder (with a subfolder matching your
-project name) when you rebuild the code. The package will automatically include your
-`manifest.json`, any `i18n` files, and the build output.
-
-To add custom files to the mod folder, just [add them to the build output](https://stackoverflow.com/a/10828462/262123).
-(If your project references another mod, make sure the reference is [_not_ marked 'copy local'](https://msdn.microsoft.com/en-us/library/t1zz5y8c(v=vs.100).aspx).)
-
-You can change the mod's folder name by adding this above the first `</PropertyGroup>` in your
-`.csproj`:
-```xml
-<ModFolderName>YourModName</ModFolderName>
-```
-
-If you don't want to deploy the mod automatically, you can add this:
-```xml
-<EnableModDeploy>False</EnableModDeploy>
-```
-
-### Create release zip
-By default, a zip file will be created in the build output when you rebuild the code. This zip file
-contains all the files needed to share your mod in the recommended format for uploading to Nexus
-Mods or other sites.
-
-You can change the zipped folder name (and zip name) by adding this above the first
-`</PropertyGroup>` in your `.csproj`:
-```xml
-<ModFolderName>YourModName</ModFolderName>
-```
-
-You can change the folder path where the zip is created like this:
-```xml
-<ModZipPath>$(SolutionDir)\_releases</ModZipPath>
-```
-
-Finally, you can disable the zip creation with this:
-```xml
-<EnableModZip>False</EnableModZip>
-```
-
-Or only create it in release builds with this:
-```xml
-<EnableModZip Condition="$(Configuration) != 'Release'">False</EnableModZip>
-```
-
-### Game path
-The package usually detects where your game is installed automatically. If it can't find your game
-or you have multiple installs, you can specify the path yourself. There's two ways to do that:
-
-* **Option 1: global game path (recommended).**  
-  _This will apply to every project that uses the package._
-
-  1. Get the full folder path containing the Stardew Valley executable.
-  2. Create this file:
-  
-     platform  | path
-     --------- | ----
-     Linux/Mac | `~/stardewvalley.targets`
-     Windows   | `%USERPROFILE%\stardewvalley.targets`
-
-  3. Save the file with this content:
-
-     ```xml
-     <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-        <PropertyGroup>
-          <GamePath>PATH_HERE</GamePath>
-        </PropertyGroup>
-     </Project>
-     ```
-
-  4. Replace `PATH_HERE` with your game path.
-
-* **Option 2: path in the project file.**  
-  _You'll need to do this for each project that uses the package._
-
-  1. Get the folder path containing the Stardew Valley `.exe` file.
-  2. Add this to your `.csproj` file under the `<Project` line:
-
-     ```xml
-     <PropertyGroup>
-       <GamePath>PATH_HERE</GamePath>
-     </PropertyGroup>
-     ```
-
-  3. Replace `PATH_HERE` with your custom game install path.
-
-The configuration will check your custom path first, then fall back to the default paths (so it'll
-still compile on a different computer).
-
-### Ignore files
-If you don't want to include a file in the mod folder or release zip:
-* Make sure it's not copied to the build output. For a DLL, make sure the reference is [not marked 'copy local'](https://msdn.microsoft.com/en-us/library/t1zz5y8c(v=vs.100).aspx).
-* Or add this to your `.csproj` file under the `<Project` line:
-  ```xml
-  <IgnoreModFilePatterns>\.txt$, \.pdf$</IgnoreModFilePatterns>
-  ```
-  This is a comma-delimited list of regular expression patterns. If any pattern matches a file's
-  relative path in your mod folder, that file won't be included.
-
-### Non-mod projects
-You can use the package in non-mod projects too (e.g. unit tests or framework DLLs). You'll need to
-disable deploying the mod and creating a release zip:
-
-```xml
-<EnableModDeploy>False</EnableModDeploy>
-<EnableModZip>False</EnableModZip>
-```
-
-If this is for unit tests, you may need to copy the referenced DLLs into your build output too:
-```xml
-<CopyModReferencesToBuildOutput>True</CopyModReferencesToBuildOutput>
-```
-
-## Code warnings
-### Overview
-The NuGet package adds code warnings in Visual Studio specific to Stardew Valley. For example:  
-![](screenshots/code-analyzer-example.png)
-
-You can hide the warnings using the warning ID (shown under 'code' in the Error List). See...
-* [for specific code](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/preprocessor-directives/preprocessor-pragma-warning);
-* for a method using this attribute:
-  ```cs
-  [System.Diagnostics.CodeAnalysis.SuppressMessage("SMAPI.CommonErrors", "AvoidNetField")]
-  ```
-* for an entire project:
-  1. Expand the _References_ node for the project in Visual Studio.
-  2. Right-click on _Analyzers_ and choose _Open Active Rule Set_.
-  4. Expand _StardewModdingAPI.ModBuildConfig.Analyzer_ and uncheck the warnings you want to hide.
-
-See below for help with each specific warning.
-
-### Avoid implicit net field cast
-Warning text:
-> This implicitly converts '{{expression}}' from {{net type}} to {{other type}}, but
-> {{net type}} has unintuitive implicit conversion rules. Consider comparing against the actual
-> value instead to avoid bugs.
-
-Stardew Valley uses net types (like `NetBool` and `NetInt`) to handle multiplayer sync. These types
-can implicitly convert to their equivalent normal values (like `bool x = new NetBool()`), but their
-conversion rules are unintuitive and error-prone. For example,
-`item?.category == null && item?.category != null` can both be true at once, and
-`building.indoors != null` can be true for a null value.
-
-Suggested fix:
-* Some net fields have an equivalent non-net property like `monster.Health` (`int`) instead of
-  `monster.health` (`NetInt`). The package will add a separate [AvoidNetField](#avoid-net-field) warning for
-  these. Use the suggested property instead.
-* For a reference type (i.e. one that can contain `null`), you can use the `.Value` property:
-  ```c#
-  if (building.indoors.Value == null)
-  ```
-  Or convert the value before comparison:
-  ```c#
-  GameLocation indoors = building.indoors;
-  if(indoors == null)
-     // ...
-  ```
-* For a value type (i.e. one that can't contain `null`), check if the object is null (if applicable)
-  and compare with `.Value`:
-  ```cs
-  if (item != null && item.category.Value == 0)
-  ```
-
-### Avoid net field
-Warning text:
-> '{{expression}}' is a {{net type}} field; consider using the {{property name}} property instead.
-
-Your code accesses a net field, which has some unusual behavior (see [AvoidImplicitNetFieldCast](#avoid-implicit-net-field-cast)).
-This field has an equivalent non-net property that avoids those issues.
-
-Suggested fix: access the suggested property name instead.
-
-### Avoid obsolete field
-Warning text:
-> The '{{old field}}' field is obsolete and should be replaced with '{{new field}}'.
-
-Your code accesses a field which is obsolete or no longer works. Use the suggested field instead.
-
-## Troubleshoot
-### "Failed to find the game install path"
-That error means the package couldn't find your game. You can specify the game path yourself; see
-_[Game path](#game-path)_ above.
-
-## Release notes
-### 2.2
-* Added support for SMAPI 2.8+ (still compatible with earlier versions).
-* Added default game paths for 32-bit Windows.
-* Fixed valid manifests marked invalid in some cases.
-
-### 2.1
-* Added support for Stardew Valley 1.3.
-* Added support for non-mod projects.
-* Added C# analyzers to warn about implicit conversions of Netcode fields in Stardew Valley 1.3.
-* Added option to ignore files by regex pattern.
-* Added reference to new SMAPI DLL.
-* Fixed some game paths not detected by NuGet package.
-
-### 2.0.2
-* Fixed compatibility issue on Linux.
-
-### 2.0.1
-* Fixed mod deploy failing to create subfolders if they don't already exist.
-
-### 2.0
-* Added: mods are now copied into the `Mods` folder automatically (configurable).
-* Added: release zips are now created automatically in your build output folder (configurable).
-* Added: mod deploy and release zips now exclude Json.NET automatically, since it's provided by SMAPI.
-* Added mod's version to release zip filename.
-* Improved errors to simplify troubleshooting.
-* Fixed release zip not having a mod folder.
-* Fixed release zip failing if mod name contains characters that aren't valid in a filename.
-
-### 1.7.1
-* Fixed issue where i18n folders were flattened.
-* The manifest/i18n files in the project now take precedence over those in the build output if both
-  are present.
-
-### 1.7
-* Added option to create release zips on build.
-* Added reference to XNA's XACT library for audio-related mods.
-
-### 1.6
-* Added support for deploying mod files into `Mods` automatically.
-* Added a build error if a game folder is found, but doesn't contain Stardew Valley or SMAPI.
-
-### 1.5
-* Added support for setting a custom game path globally.
-* Added default GOG path on Mac.
-
-### 1.4
-* Fixed detection of non-default game paths on 32-bit Windows.
-* Removed support for SilVerPLuM (discontinued).
-* Removed support for overriding the target platform (no longer needed since SMAPI crossplatforms
-  mods automatically).
-
-### 1.3
-* Added support for non-default game paths on Windows.
-
-### 1.2
-* Exclude game binaries from mod build output.
-
-### 1.1
-* Added support for overriding the target platform.
-
-### 1.0
-* Initial release.
-* Added support for detecting the game path automatically.
-* Added support for injecting XNA/MonoGame references automatically based on the OS.
-* Added support for mod builders like SilVerPLuM.
+[Documentation moved](technical/mod-package.md).
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5a7d5ef2..a891c495 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,4 +1,155 @@
+&larr; [README](README.md)
+
 # Release notes
+## 3.0
+Released 26 November 2019 for Stardew Valley 1.4.
+
+### Release highlights
+For players:
+* **Updated for Stardew Valley 1.4.**  
+  SMAPI 3.0 adds compatibility with the latest game version, and improves mod APIs for changes in
+  the game code.
+
+* **Improved performance.**  
+  SMAPI should have less impact on game performance and startup time for some players.
+
+* **Automatic save fixing and more error recovery.**  
+  SMAPI now detects and prevents more crashes due to game/mod bugs, and automatically fixes your
+  save if you remove some custom-content mods.
+
+* **Improved mod scanning.**  
+  SMAPI now supports some non-standard mod structures automatically, improves compatibility with
+  the Vortex mod manager, and improves various error/skip messages related to mod loading.
+
+* **Overhauled update checks.**  
+  SMAPI update checks are now handled entirely on the web server and support community-defined
+  version mappings. In particular, false update alerts due to author mistakes can now be solved by
+  the community for all players.
+
+* **Fixed many bugs and edge cases.**
+
+For modders:
+* **New event system.**  
+  SMAPI 3.0 removes the deprecated static events in favor of the new `helper.Events` API. The event
+  engine is rewritten to make events more efficient, add events that weren't possible before, make
+  existing events more useful, and make event usage and behavior more consistent. When a mod makes
+  changes in an event handler, those changes are now also reflected in the next event raise.
+
+* **Improved mod build package.**  
+  The [mod build package](https://www.nuget.org/packages/Pathoschild.Stardew.ModBuildConfig) now
+  includes the `assets` folder by default if present, supports the new `.csproj` project format,
+  enables mod `.pdb` files automatically (to provide line numbers in error messages), adds optional
+  Harmony support, and fixes some bugs and edge cases. This also adds compatibility with SMAPI 3.0
+  and Stardew Valley 1.4, and drops support for older versions.
+
+* **Mods loaded earlier.**  
+  SMAPI now loads mods much earlier, before the game is initialised. That lets mods do things that
+  were difficult before, like intercepting some core assets.
+
+* **Improved Android support.**  
+  SMAPI now automatically detects when it's running on Android, and updates `Constants.TargetPlatform`
+  so mods can adjust their logic if needed. The Save Backup mod is also now Android-compatible.
+
+* **Improved asset propagation.**  
+  SMAPI now automatically propagates asset changes for farm animal data, NPC default location data,
+  critter textures, and `DayTimeMoneyBox` buttons. Every loaded texture now also has a `Name` field
+  so mods can check which asset a texture was loaded for.
+
+* **Breaking changes:**  
+  See _[migrate to SMAPI 3.0](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_3.0)_ and
+  _[migrate to Stardew Valley 1.4](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.4)_
+  for more info.
+
+### For players
+* Changes:
+  * Updated for Stardew Valley 1.4.
+  * Improved performance.
+  * Reworked update checks and added community-defined version mapping, to reduce false update alerts due to author mistakes.
+  * SMAPI now removes invalid locations/NPCs when loading a save to prevent crashes. A warning is shown in-game when this happens.
+  * Added update checks for CurseForge mods.
+  * Added support for editing console colors via `smapi-internal/config.json` (for players with unusual consoles).
+  * Added support for setting SMAPI CLI arguments as environment variables for Linux/macOS compatibility.
+  * Improved mod scanning:
+    * Now ignores metadata files/folders (like `__MACOSX` and `__folder_managed_by_vortex`) and content files (like `.txt` or `.png`), which avoids missing-manifest errors in some cases.
+    * Now detects XNB mods more accurately, and consolidates multi-folder XNB mods in logged messages.
+  * Improved launch script compatibility on Linux (thanks to kurumushi and toastal!).
+  * Made error messages more user-friendly in some cases.
+  * Save Backup now works in the background, to avoid affecting startup time for players with a large number of saves.
+  * The installer now recognises custom game paths stored in [`stardewvalley.targets`](http://smapi.io/package/custom-game-path).
+  * Duplicate-mod errors now show the mod version in each folder.
+  * Update checks are now faster in some cases.
+  * Updated mod compatibility list.
+  * Updated SMAPI/game version map.
+* Fixes:
+  * Fixed some assets not updated when you switch language to English.
+  * Fixed lag in some cases due to incorrect asset caching when playing in non-English.
+  * Fixed lag when a mod invalidates many NPC portraits/sprites at once.
+  * Fixed Console Commands not including upgraded tools in item commands.
+  * Fixed Console Commands' item commands failing if a mod adds invalid item data.
+  * Fixed Save Backup not pruning old backups if they're uncompressed.
+  * Fixed issues when a farmhand reconnects before the game notices they're disconnected.
+  * Fixed 'received message' logs shown in non-developer mode.
+  * Fixed various error messages and inconsistent spelling.
+  * Fixed update-check error if a Nexus mod is marked as adult content.
+  * Fixed update-check error if the Chucklefish page for an update key doesn't exist.
+
+### For the web UI
+* Mod compatibility list:
+  * Added support for CurseForge mods.
+  * Added metadata links and dev notes (if any) to advanced info.
+  * Now loads faster (since data is fetched in a background service).
+  * Now continues working with cached data when the wiki is offline.
+  * Clicking a mod link now automatically adds it to the visible mods if the list is filtered.
+
+* JSON validator:
+  * Added JSON validator at [json.smapi.io](https://json.smapi.io), which lets you validate a JSON file against predefined mod formats.
+  * Added support for the `manifest.json` format.
+  * Added support for the Content Patcher format (thanks to TehPers!).
+  * Added support for referencing a schema in a JSON Schema-compatible text editor.
+
+* For the log parser:
+  * Added instructions for Android.
+  * The page now detects your OS and preselects the right instructions (thanks to danvolchek!).
+
+### For modders
+* Breaking changes:
+  * Mods are now loaded much earlier in the game launch. This lets mods intercept any content asset, but the game is not fully initialized when `Entry` is called; use the `GameLaunched` event if you need to run code when the game is initialized.
+  * Removed all deprecated APIs.
+  * Removed unused APIs: `Monitor.ExitGameImmediately`, `Translation.ModName`, and `Translation.Assert`.
+  * Fixed `ICursorPosition.AbsolutePixels` not adjusted for zoom.
+  * `SemanticVersion` no longer omits `.0` patch numbers when formatting versions, for better [semver](https://semver.org/) conformity (e.g. `3.0` is now formatted as `3.0.0`).
+* Changes:
+  * Added support for content pack translations.
+  * Added `IContentPack.HasFile`, `Context.IsGameLaunched`, and `SemanticVersion.TryParse`.
+  * Added separate `LogNetworkTraffic` option to make verbose logging less overwhelmingly verbose.
+  * Added asset propagation for `Data\FarmAnimals`, critter textures, and `DayTimeMoneyBox` buttons.
+  * Added `Texture2D.Name` values set to the asset key.
+  * Added trace logs for skipped loose files in the `Mods` folder and custom SMAPI settings so it's easier to troubleshoot player logs.
+  * `Constants.TargetPlatform` now returns `Android` when playing on an Android device.
+  * Trace logs for a broken mod now list all detected issues (instead of the first one).
+  * Trace logs when loading mods are now more clear.
+  * Clarified update-check errors for mods with multiple update keys.
+  * Updated dependencies (including Json.NET 11.0.2 → 12.0.3 and Mono.Cecil 0.10.1 → 0.11.1).
+* Fixes:
+  * Fixed map reloads resetting tilesheet seasons.
+  * Fixed map reloads not updating door warps.
+  * Fixed outdoor tilesheets being seasonalised when added to an indoor location.
+  * Fixed mods needing to load custom `Map` assets before the game accesses them. SMAPI now does so automatically.
+  * Fixed custom maps loaded from `.xnb` files not having their tilesheet paths automatically adjusted.
+  * Fixed custom maps loaded from the mod folder with tilesheets in a subfolder not working crossplatform. All tilesheet paths are now normalized for the OS automatically.
+  * Fixed issue where mod changes weren't tracked correctly for raising events in some cases. Events now reflect a frozen snapshot of the game state, and any mod changes are reflected in the next event tick.
+  * Fixed issue where, when a mod's `IAssetEditor` uses `asset.ReplaceWith` on a texture asset while playing in non-English, any changes from that point forth wouldn't affect subsequent cached asset loads.
+  * Fixed asset propagation for NPC portraits resetting any unique portraits (e.g. Maru's hospital portrait) to the default.
+  * Fixed changes to `Data\NPCDispositions` not always propagated correctly to existing NPCs.
+  * Fixed `Rendering`/`Rendered` events not raised during minigames.
+  * Fixed `LoadStageChanged` event not raising correct flags in some cases when creating a new save.
+  * Fixed `GetApi` without an interface not checking if all mods are loaded.
+
+### For SMAPI maintainers
+* Added support for core translation files.
+* Migrated to new `.csproj` format.
+* Internal refactoring.
+
 ## 2.11.3
 Released 13 September 2019 for Stardew Valley 1.3.36.
 
@@ -12,11 +163,14 @@ Released 13 September 2019 for Stardew Valley 1.3.36.
 * For the web UI:
   * When filtering the mod list, clicking a mod link now automatically adds it to the visible mods.
   * Added log parser instructions for Android.
-  * Fixed log parser failing in some cases due to time format localisation.
+  * Fixed log parser failing in some cases due to time format localization.
 
 * For modders:
   * `this.Monitor.Log` now defaults to the `Trace` log level instead of `Debug`. The change will only take effect when you recompile the mod.
   * Fixed 'location list changed' verbose log not correctly listing changes.
+  * Fixed mods able to directly load (and in some cases edit) a different mod's local assets using internal asset key forwarding.
+  * Fixed changes to a map loaded by a mod being persisted across content managers.
+  * Fixed `SDate.AddDays` incorrectly changing year when the result is exactly winter 28.
 
 ## 2.11.2
 Released 23 April 2019 for Stardew Valley 1.3.36.
@@ -77,12 +231,12 @@ Released 09 January 2019 for Stardew Valley 1.3.32–33.
   * Added locale to context trace logs.
   * Fixed error loading custom map tilesheets in some cases.
   * Fixed error when swapping maps mid-session for a location with interior doors.
-  * Fixed `Constants.SaveFolderName` and `CurrentSavePath` not available during early load stages when using `Specialised.LoadStageChanged` event.
+  * Fixed `Constants.SaveFolderName` and `CurrentSavePath` not available during early load stages when using `Specialized.LoadStageChanged` event.
   * Fixed `LoadStage.SaveParsed` raised before the parsed save data is available.
   * Fixed 'unknown mod' deprecation warnings showing the wrong stack trace.
   * Fixed `e.Cursor` in input events showing wrong grab tile when player using a controller moves without moving the viewpoint.
-  * Fixed incorrect 'bypassed safety checks' warning for mods using the new `Specialised.LoadStageChanged` event in 2.10.
-  * Deprecated `EntryDll` values whose capitalisation don't match the actual file. (This works on Windows, but causes errors for Linux/Mac players.)
+  * Fixed incorrect 'bypassed safety checks' warning for mods using the new `Specialized.LoadStageChanged` event in 2.10.
+  * Deprecated `EntryDll` values whose capitalization don't match the actual file. (This works on Windows, but causes errors for Linux/Mac players.)
 
 ## 2.10.1
 Released 30 December 2018 for Stardew Valley 1.3.32–33.
@@ -99,9 +253,9 @@ Released 29 December 2018 for Stardew Valley 1.3.32–33.
   * Tweaked installer to reduce antivirus false positives.
 
 * For modders:
-  * Added [events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events): `GameLoop.OneSecondUpdateTicking`, `GameLoop.OneSecondUpdateTicked`, and `Specialised.LoadStageChanged`.
+  * Added [events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events): `GameLoop.OneSecondUpdateTicking`, `GameLoop.OneSecondUpdateTicked`, and `Specialized.LoadStageChanged`.
   * Added `e.IsCurrentLocation` event arg to `World` events.
-  * You can now use `helper.Data.Read/WriteSaveData` as soon as the save is loaded (instead of once the world is initialised).
+  * You can now use `helper.Data.Read/WriteSaveData` as soon as the save is loaded (instead of once the world is initialized).
   * Increased deprecation levels to _info_ for the upcoming SMAPI 3.0.
 
 * For the web UI:
@@ -274,7 +428,7 @@ Released 14 August 2018 for Stardew Valley 1.3.28.
     * dialogue;
     * map tilesheets.
   * Added `--mods-path` CLI command-line argument to switch between mod folders.
-  * All enums are now JSON-serialised by name instead of numeric value. (Previously only a few enums were serialised that way. JSON files which already have numeric enum values will still be parsed fine.)
+  * All enums are now JSON-serialized by name instead of numeric value. (Previously only a few enums were serialized that way. JSON files which already have numeric enum values will still be parsed fine.)
   * Fixed false compatibility error when constructing multidimensional arrays.
   * Fixed `.ToSButton()` methods not being public.
 
@@ -301,7 +455,7 @@ Released 01 August 2018 for Stardew Valley 1.3.27.
   * Improved the Console Commands mod:
     * Added `player_add name`, which adds items to your inventory by name instead of ID.
     * Fixed `world_setseason` not running season-change logic.
-    * Fixed `world_setseason` not normalising the season value.
+    * Fixed `world_setseason` not normalizing the season value.
     * Fixed `world_settime` sometimes breaking NPC schedules (e.g. so they stay in bed).
     * Removed the `player_setlevel` and `player_setspeed` commands, which weren't implemented in a useful way. Use a mod like CJB Cheats Menu if you need those.
   * Fixed `SEHException` errors for some players.
@@ -392,7 +546,7 @@ Released 11 April 2018 for Stardew Valley 1.2.30–1.2.33.
   * Fixed mod update alerts not shown if one mod has an invalid remote version.
   * Fixed SMAPI update alerts linking to the GitHub repository instead of [smapi.io](https://smapi.io).
   * Fixed SMAPI update alerts for draft releases.
-  * Fixed error when two content packs use different capitalisation for the same required mod ID.
+  * Fixed error when two content packs use different capitalization for the same required mod ID.
   * Fixed rare crash if the game duplicates an item.
 
 * For the [log parser](https://log.smapi.io):
@@ -467,8 +621,8 @@ Released 24 February 2018 for Stardew Valley 1.2.30–1.2.33.
 * For modders:
   * Added support for content packs and new APIs to read them.
   * Added support for `ISemanticVersion` in JSON models.
-  * Added `SpecialisedEvents.UnvalidatedUpdateTick` event for specialised use cases.
-  * Added path normalising to `ReadJsonFile` and `WriteJsonFile` helpers (so no longer need `Path.Combine` with those).
+  * Added `SpecializedEvents.UnvalidatedUpdateTick` event for specialized use cases.
+  * Added path normalizing to `ReadJsonFile` and `WriteJsonFile` helpers (so no longer need `Path.Combine` with those).
   * Fixed deadlock in rare cases with asset loaders.
   * Fixed unhelpful error when a mod exposes a non-public API.
   * Fixed unhelpful error when a translation file has duplicate keys due to case-insensitivity.
@@ -521,11 +675,11 @@ Released 26 December 2017 for Stardew Valley 1.2.30–1.2.33.
 
 * For modders:
   * **Added mod-provided APIs** to allow simple integrations between mods, even without direct assembly references.
-  * Added `GameEvents.FirstUpdateTick` event (called once after all mods are initialised).
+  * Added `GameEvents.FirstUpdateTick` event (called once after all mods are initialized).
   * Added `IsSuppressed` to input events so mods can optionally avoid handling keys another mod has already handled.
   * Added trace message for mods with no update keys.
   * Adjusted reflection API to match actual usage (e.g. renamed `GetPrivate*` to `Get*`), and deprecated previous methods.
-  * Fixed `GraphicsEvents.OnPostRenderEvent` not being raised in some specialised cases.
+  * Fixed `GraphicsEvents.OnPostRenderEvent` not being raised in some specialized cases.
   * Fixed reflection API error for properties missing a `get` and `set`.
   * Fixed issue where a mod could change the cursor position reported to other mods.
   * Updated compatibility list.
@@ -550,7 +704,7 @@ Released 02 December 2017 for Stardew Valley 1.2.30–1.2.33.
   * Slightly improved the UI.
 
 * For modders:
-  * Added `helper.Content.NormaliseAssetName` method.
+  * Added `helper.Content.NormalizeAssetName` method.
   * Added `SDate.DaysSinceStart` property.
   * Fixed input events' `e.SuppressButton(button)` method ignoring specified button.
   * Fixed input events' `e.SuppressButton()` method not working with mouse buttons.
@@ -634,7 +788,7 @@ Released 14 October 2017 for Stardew Valley 1.2.30–1.2.33.
 
 * **Command-line install**
   For power users and mod managers, the SMAPI installer can now be scripted using command-line arguments
-  (see [technical docs](technical-docs.md#command-line-arguments)).
+  (see [technical docs](technical/smapi.md#command-line-arguments)).
 
 ### Change log
 For players:
@@ -705,7 +859,7 @@ For mod developers:
 * Added content helper properties for the game's current language.
 * Fixed `Context.IsPlayerFree` being false if the player is performing an action.
 * Fixed `GraphicsEvents.Resize` being raised before the game updates its window data.
-* Fixed `SemanticVersion` not being deserialisable through Json.NET.
+* Fixed `SemanticVersion` not being deserializable through Json.NET.
 * Fixed terminal not launching on Xfce Linux.
 
 For SMAPI developers:
@@ -776,7 +930,7 @@ For modders:
 * SMAPI now automatically fixes tilesheet references for maps loaded from the mod folder.  
   <small>_When loading a map from the mod folder, SMAPI will automatically use tilesheets relative to the map file if they exists. Otherwise it will default to tilesheets in the game content._</small>
 * Added `Context.IsPlayerFree` for mods that need to check if the player can act (i.e. save is loaded, no menu is displayed, no cutscene is in progress, etc).
-* Added `Context.IsInDrawLoop` for specialised mods.
+* Added `Context.IsInDrawLoop` for specialized mods.
 * Fixed `smapi-crash.txt` being copied from the default log even if a different path is specified with `--log-path`.
 * Fixed the content API not matching XNB filenames with two dots (like `a.b.xnb`) if you don't specify the `.xnb` extension.
 * Fixed `debug` command output not printed to console.
@@ -803,7 +957,7 @@ For players:
 
 For mod developers:
 * Added a `Context.IsWorldReady` flag for mods to use.  
-  <small>_This indicates whether a save is loaded and the world is finished initialising, which starts at the same point that `SaveEvents.AfterLoad` and `TimeEvents.AfterDayStarted` are raised. This is mainly useful for events which can be raised before the world is loaded (like update tick)._</small>
+  <small>_This indicates whether a save is loaded and the world is finished initializing, which starts at the same point that `SaveEvents.AfterLoad` and `TimeEvents.AfterDayStarted` are raised. This is mainly useful for events which can be raised before the world is loaded (like update tick)._</small>
 * Added a `debug` console command which lets you run the game's debug commands (e.g. `debug warp FarmHouse 1 1` warps you to the farmhouse).
 * Added basic context info to logs to simplify troubleshooting.
 * Added a `Mod.Dispose` method which can be overriden to clean up before exit. This method isn't guaranteed to be called on every exit.
@@ -841,8 +995,8 @@ For players:
 For mod developers:
 * Added a content API which loads custom textures/maps/data from the mod's folder (`.xnb` or `.png` format) or game content.
 * `Console.Out` messages are now written to the log file.
-* `Monitor.ExitGameImmediately` now aborts SMAPI initialisation and events more quickly.
-* Fixed value-changed events being raised when the player loads a save due to values being initialised.
+* `Monitor.ExitGameImmediately` now aborts SMAPI initialization and events more quickly.
+* Fixed value-changed events being raised when the player loads a save due to values being initialized.
 
 ## 1.10
 Released 24 April 2017 for Stardew Valley 1.2.26.
@@ -858,7 +1012,7 @@ For players:
   * Replaced `player_addmelee` with `player_addweapon` with support for non-melee weapons.
 
 For mod developers:
-* Mods are now initialised after the `Initialize`/`LoadContent` phase, which means the `GameEvents.Initialize` and `GameEvents.LoadContent` events are deprecated. You can move any logic in those methods to your mod's `Entry` method.
+* Mods are now initialized after the `Initialize`/`LoadContent` phase, which means the `GameEvents.Initialize` and `GameEvents.LoadContent` events are deprecated. You can move any logic in those methods to your mod's `Entry` method.
 * Added `IsBetween` and string overloads to the `ISemanticVersion` methods.
 * Fixed mouse-changed event never updating prior mouse position.
 * Fixed `monitor.ExitGameImmediately` not working correctly.
@@ -897,7 +1051,7 @@ For mod developers:
 * The SMAPI log now has a simpler filename.
 * The SMAPI log now shows the OS caption (like "Windows 10") instead of its internal version when available.
 * The SMAPI log now always uses `\r\n` line endings to simplify crossplatform viewing.
-* Fixed `SaveEvents.AfterLoad` being raised during the new-game intro before the player is initialised.
+* Fixed `SaveEvents.AfterLoad` being raised during the new-game intro before the player is initialized.
 * Fixed SMAPI not recognising `Mod` instances that don't subclass `Mod` directly.
 * Several obsolete APIs have been removed (see [migration guides](https://stardewvalleywiki.com/Modding:Index#Migration_guides)),
   and all _notice_-level deprecations have been increased to _info_.
@@ -942,7 +1096,7 @@ For mod developers:
 * Added a mod registry which provides metadata about loaded mods.
 * The `Entry(…)` method is now deferred until all mods are loaded.
 * Fixed `SaveEvents.BeforeSave` and `.AfterSave` not triggering on days when the player shipped something.
-* Fixed `PlayerEvents.LoadedGame` and `SaveEvents.AfterLoad` being fired before the world finishes initialising.
+* Fixed `PlayerEvents.LoadedGame` and `SaveEvents.AfterLoad` being fired before the world finishes initializing.
 * Fixed some `LocationEvents`, `PlayerEvents`, and `TimeEvents` being fired during game startup.
 * Increased deprecation levels for `SObject`, `LogWriter` (not `Log`), and `Mod.Entry(ModHelper)` (not `Mod.Entry(IModHelper)`) to _pending removal_. Increased deprecation levels for `Mod.PerSaveConfigFolder`, `Mod.PerSaveConfigPath`, and `Version.VersionString` to _info_.
 
diff --git a/docs/technical-docs.md b/docs/technical-docs.md
deleted file mode 100644
index 98dd3540..00000000
--- a/docs/technical-docs.md
+++ /dev/null
@@ -1,232 +0,0 @@
-&larr; [README](README.md)
-
-This file provides more technical documentation about SMAPI. If you only want to use or create
-mods, this section isn't relevant to you; see the main README to use or create mods.
-
-# Contents
-* [SMAPI](#smapi)
-  * [Development](#development)
-    * [Compiling from source](#compiling-from-source)
-    * [Debugging a local build](#debugging-a-local-build)
-    * [Preparing a release](#preparing-a-release)
-  * [Customisation](#customisation)
-    * [Configuration file](#configuration-file)
-    * [Command-line arguments](#command-line-arguments)
-    * [Compile flags](#compile-flags)
-* [SMAPI web services](#smapi-web-services)
-  * [Overview](#overview)
-    * [Log parser](#log-parser)
-    * [Web API](#web-api)
-  * [Development](#development-2)
-    * [Local development](#loc