move technical docs out of README

2 files changed, 141 insertions, 136 deletions

diff --git a/docs/README.md b/docs/README.md
index 01dd77ce..37aa50fe 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -40,140 +40,8 @@ doesn't change any of your game files. It serves five main purposes:
    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._
 
-## For players
-* [Intro & FAQs](http://stardewvalleywiki.com/Modding:Player_FAQs)
-* [Installing SMAPI](http://stardewvalleywiki.com/Modding:Installing_SMAPI)
-* [Release notes](release-notes.md#release-notes)
-* Need help? Come [chat on Discord](https://discord.gg/KCJHWhX) or [post in the support forums](http://community.playstarbound.com/threads/smapi-stardew-modding-api.108375/).  
-  _Please don't submit issues on GitHub for support questions._
-
-## For mod developers
-* [Modding documentation](http://stardewvalleywiki.com/Modding:Index)
-* [Release notes](release-notes.md#release-notes)
+## Documentation
+* [For players & mod creators](http://stardewvalleywiki.com/Modding:Index)
+* [Release notes](release-notes.md)
+* [Technical docs](technical-docs.md)
 * [Chat on Discord](https://discord.gg/KCJHWhX) with SMAPI developers and other modders
-
-## For SMAPI developers
-_This section is about compiling SMAPI itself from source. If you don't know what that means, this
-section isn't relevant to you; see the previous sections to use or create mods._
-
-### Compiling from source
-Using an official SMAPI release is recommended for most users.
-
-SMAPI uses some C# 7 code, so you'll need at least
-[Visual Studio 2017](https://www.visualstudio.com/vs/community/) on Windows,
-[MonoDevelop 7.0](http://www.monodevelop.com/) on Linux,
-[Visual Studio 2017 for Mac](https://www.visualstudio.com/vs/visual-studio-mac/), or an equivalent
-IDE to compile it. It uses build configuration derived from the
-[crossplatform mod config](https://github.com/Pathoschild/Stardew.ModBuildConfig#readme) to detect
-your current OS automatically and load the correct references. Compile output will be placed in a
-`bin` folder at the root of the git repository.
-
-### Debugging a local build
-Rebuilding the solution in debug mode will copy the SMAPI files into your game folder. Starting
-the `StardewModdingAPI` project with debugging from Visual Studio (on Mac or Windows) will launch
-SMAPI with the debugger attached, so you can intercept errors and step through the code being
-executed. This doesn't work in MonoDevelop on Linux, unfortunately.
-
-### Preparing a release
-To prepare a crossplatform SMAPI release, you'll need to compile it on two platforms. See
-[crossplatforming info](http://stardewvalleywiki.com/Modding:Creating_a_SMAPI_mod#Test_on_all_platforms)
-on the wiki for the first-time setup.
-
-1. Update the version number in `GlobalAssemblyInfo.cs` and `Constants::Version`. Make sure you use a
-   [semantic version](http://semver.org). Recommended format:
-
-   build type | format                            | example
-   :--------- | :-------------------------------- | :------
-   dev build  | `<version>-alpha.<timestamp>`     | `2.0-alpha.20171230`
-   prerelease | `<version>-prerelease.<ID>`       | `2.0-prerelease.2`
-   release    | `<version>`                       | `2.0`
-
-2. In Windows:
-   1. Rebuild the solution in _Release_ mode.
-   2. Rename `bin/Packaged` to `SMAPI <version>` (e.g. `SMAPI 2.0`).
-   2. Transfer the `SMAPI <version>` folder to Linux or Mac.  
-      _This adds the installer executable and Windows files. We'll do the rest in Linux or Mac,
-      since we need to set Unix file permissions that Windows won't save._
-
-2. In Linux or Mac:
-   1. Rebuild the solution in _Release_ mode.
-   2. Copy `bin/internal/Packaged/Mono` into the `SMAPI <version>` folder.
-   3. If you did everything right so far, you should have a folder like this:
-
-      ```
-      SMAPI-2.x/
-         install.exe
-         readme.txt
-         internal/
-            Mono/
-               Mods/*
-               Mono.Cecil.dll
-               Newtonsoft.Json.dll
-               StardewModdingAPI
-               StardewModdingAPI.AssemblyRewriters.dll
-               StardewModdingAPI.config.json
-               StardewModdingAPI.exe
-               StardewModdingAPI.pdb
-               StardewModdingAPI.xml
-               steam_appid.txt
-               System.Numerics.dll
-               System.Runtime.Caching.dll
-               System.ValueTuple.dll
-            Windows/
-               Mods/*
-               Mono.Cecil.dll
-               Newtonsoft.Json.dll
-               StardewModdingAPI.AssemblyRewriters.dll
-               StardewModdingAPI.config.json
-               StardewModdingAPI.exe
-               StardewModdingAPI.pdb
-               StardewModdingAPI.xml
-               System.ValueTuple.dll
-               steam_appid.txt
-      ```
-   4. Open a terminal in the `SMAPI <version>` folder and run `chmod 755 internal/Mono/StardewModdingAPI`.
-   5. Copy & paste the `SMAPI <version>` folder as `SMAPI <version> for developers`.
-   6. In the `SMAPI <version>` folder...
-      * edit `internal/Mono/StardewModdingAPI.config.json` and
-        `internal/Windows/StardewModdingAPI.config.json` to disable developer mode;
-      * delete `internal/Windows/StardewModdingAPI.xml`.
-   7. Compress the two folders into `SMAPI <version>.zip` and `SMAPI <version> for developers.zip`.
-
-## Advanced usage
-### Configuration file
-You can customise the SMAPI behaviour by editing the `StardewModdingAPI.config.json` file in your
-game folder.
-
-Basic fields:
-
-field             | purpose
------------------ | -------
-`DeveloperMode`   | Default `false` (except in _SMAPI for developers_ releases). Whether to enable features intended for mod developers (mainly more detailed console logging).
-`CheckForUpdates` | Default `true`. Whether SMAPI should check for a newer version when you load the game. If a new version is available, a small message will appear in the console. This doesn't affect the load time even if your connection is offline or slow, because it happens in the background.
-`VerboseLogging`  | Default `false`. Whether SMAPI should log more information about the game context.
-`ModData`         | Internal metadata about SMAPI mods. Changing this isn't recommended and may destabilise your game. See documentation in the file.
-
-### Command-line arguments
-The SMAPI installer recognises three command-line arguments:
-
-argument | purpose
--------- | -------
-`--install` | Preselects the install action, skipping the prompt asking what the user wants to do.
-`--uninstall` | Preselects the uninstall action, skipping the prompt asking what the user wants to do.
-`--game-path "path"` | Specifies the full path to the folder containing the Stardew Valley executable, skipping automatic detection and any prompt to choose a path. If the path is not valid, the installer displays an error.
-
-SMAPI itself recognises two arguments, but these are intended for internal use or testing and may
-change without warning.
-
-argument | purpose
--------- | -------
-`--log-path "path"` | The relative or absolute path of the log file SMAPI should write.
-`--no-terminal` | SMAPI won't write anything to the console window. (Messages will still be written to the log file.)
-
-### Compile flags
-SMAPI uses a small number of conditional compilation constants, which you can set by editing the
-`<DefineConstants>` element in `StardewModdingAPI.csproj`. Supported constants:
-
-flag | purpose
----- | -------
-`SMAPI_FOR_WINDOWS` | Indicates that SMAPI is being compiled on Windows for players on Windows. Set automatically in `crossplatform.targets`.
diff --git a/docs/technical-docs.md b/docs/technical-docs.md
new file mode 100644
index 00000000..d37d327d
--- /dev/null
+++ b/docs/technical-docs.md
@@ -0,0 +1,137 @@
+&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
+* [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)
+
+## Development
+### Compiling from source
+Using an official SMAPI release is recommended for most users.
+
+SMAPI uses some C# 7 code, so you'll need at least
+[Visual Studio 2017](https://www.visualstudio.com/vs/community/) on Windows,
+[MonoDevelop 7.0](http://www.monodevelop.com/) on Linux,
+[Visual Studio 2017 for Mac](https://www.visualstudio.com/vs/visual-studio-mac/), or an equivalent
+IDE to compile it. It uses build configuration derived from the
+[crossplatform mod config](https://github.com/Pathoschild/Stardew.ModBuildConfig#readme) to detect
+your current OS automatically and load the correct references. Compile output will be placed in a
+`bin` folder at the root of the git repository.
+
+### Debugging a local build
+Rebuilding the solution in debug mode will copy the SMAPI files into your game folder. Starting
+the `StardewModdingAPI` project with debugging from Visual Studio (on Mac or Windows) will launch
+SMAPI with the debugger attached, so you can intercept errors and step through the code being
+executed. This doesn't work in MonoDevelop on Linux, unfortunately.
+
+### Preparing a release
+To prepare a crossplatform SMAPI release, you'll need to compile it on two platforms. See
+[crossplatforming info](http://stardewvalleywiki.com/Modding:Creating_a_SMAPI_mod#Test_on_all_platforms)
+on the wiki for the first-time setup.
+
+1. Update the version number in `GlobalAssemblyInfo.cs` and `Constants::Version`. Make sure you use a
+   [semantic version](http://semver.org). Recommended format:
+
+   build type | format                            | example
+   :--------- | :-------------------------------- | :------
+   dev build  | `<version>-alpha.<timestamp>`     | `2.0-alpha.20171230`
+   prerelease | `<version>-prerelease.<ID>`       | `2.0-prerelease.2`
+   release    | `<version>`                       | `2.0`
+
+2. In Windows:
+   1. Rebuild the solution in _Release_ mode.
+   2. Rename `bin/Packaged` to `SMAPI <version>` (e.g. `SMAPI 2.0`).
+   2. Transfer the `SMAPI <version>` folder to Linux or Mac.  
+      _This adds the installer executable and Windows files. We'll do the rest in Linux or Mac,
+      since we need to set Unix file permissions that Windows won't save._
+
+2. In Linux or Mac:
+   1. Rebuild the solution in _Release_ mode.
+   2. Copy `bin/internal/Packaged/Mono` into the `SMAPI <version>` folder.
+   3. If you did everything right so far, you should have a folder like this:
+
+      ```
+      SMAPI-2.x/
+         install.exe
+         readme.txt
+         internal/
+            Mono/
+               Mods/*
+               Mono.Cecil.dll
+               Newtonsoft.Json.dll
+               StardewModdingAPI
+               StardewModdingAPI.AssemblyRewriters.dll
+               StardewModdingAPI.config.json
+               StardewModdingAPI.exe
+               StardewModdingAPI.pdb
+               StardewModdingAPI.xml
+               steam_appid.txt
+               System.Numerics.dll
+               System.Runtime.Caching.dll
+               System.ValueTuple.dll
+            Windows/
+               Mods/*
+               Mono.Cecil.dll
+               Newtonsoft.Json.dll
+               StardewModdingAPI.AssemblyRewriters.dll
+               StardewModdingAPI.config.json
+               StardewModdingAPI.exe
+               StardewModdingAPI.pdb
+               StardewModdingAPI.xml
+               System.ValueTuple.dll
+               steam_appid.txt
+      ```
+   4. Open a terminal in the `SMAPI <version>` folder and run `chmod 755 internal/Mono/StardewModdingAPI`.
+   5. Copy & paste the `SMAPI <version>` folder as `SMAPI <version> for developers`.
+   6. In the `SMAPI <version>` folder...
+      * edit `internal/Mono/StardewModdingAPI.config.json` and
+        `internal/Windows/StardewModdingAPI.config.json` to disable developer mode;
+      * delete `internal/Windows/StardewModdingAPI.xml`.
+   7. Compress the two folders into `SMAPI <version>.zip` and `SMAPI <version> for developers.zip`.
+
+## Customisation
+### Configuration file
+You can customise the SMAPI behaviour by editing the `StardewModdingAPI.config.json` file in your
+game folder.
+
+Basic fields:
+
+field             | purpose
+----------------- | -------
+`DeveloperMode`   | Default `false` (except in _SMAPI for developers_ releases). Whether to enable features intended for mod developers (mainly more detailed console logging).
+`CheckForUpdates` | Default `true`. Whether SMAPI should check for a newer version when you load the game. If a new version is available, a small message will appear in the console. This doesn't affect the load time even if your connection is offline or slow, because it happens in the background.
+`VerboseLogging`  | Default `false`. Whether SMAPI should log more information about the game context.
+`ModData`         | Internal metadata about SMAPI mods. Changing this isn't recommended and may destabilise your game. See documentation in the file.
+
+### Command-line arguments
+The SMAPI installer recognises three command-line arguments:
+
+argument | purpose
+-------- | -------
+`--install` | Preselects the install action, skipping the prompt asking what the user wants to do.
+`--uninstall` | Preselects the uninstall action, skipping the prompt asking what the user wants to do.
+`--game-path "path"` | Specifies the full path to the folder containing the Stardew Valley executable, skipping automatic detection and any prompt to choose a path. If the path is not valid, the installer displays an error.
+
+SMAPI itself recognises two arguments, but these are intended for internal use or testing and may
+change without warning.
+
+argument | purpose
+-------- | -------
+`--log-path "path"` | The relative or absolute path of the log file SMAPI should write.
+`--no-terminal` | SMAPI won't write anything to the console window. (Messages will still be written to the log file.)
+
+### Compile flags
+SMAPI uses a small number of conditional compilation constants, which you can set by editing the
+`<DefineConstants>` element in `StardewModdingAPI.csproj`. Supported constants:
+
+flag | purpose
+---- | -------
+`SMAPI_FOR_WINDOWS` | Indicates that SMAPI is being compiled on Windows for players on Windows. Set automatically in `crossplatform.targets`.