dotnet · KevinRansom · Sep 10, 2020 · Sep 8, 2020
diff --git a/README.md b/README.md
@@ -38,9 +38,15 @@ If you'd like to use Visual Studio online (or VSCode with VSO as backend), just
 
 This will provision an environment with all necessary dependencies. Initial build of the environment may take up to 10 minutes, as it's also performing initial build of the F# compiler.
 
-### More options and information
+### Documentation for contributors
 
-See [DEVGUIDE.md](DEVGUIDE.md) and [TESTGUIDE.md](TESTGUIDE.md) for more details on additional configurations for building and testing, how to update compiler error messages, and more.
+See [DEVGUIDE.md](DEVGUIDE.md) for more details on configurations for building the codebase. In practice, you only really need to run `build.cmd`/`build.sh`.
+
+See [TESTGUIDE.md](TESTGUIDE.md) for information about the various test suites in this codebase and how to run them individually.
+
+See the [Compiler Guide](docs/compiler-guide.md) for an in-depth guide to the F# compiler. It is essential reading for any larger contributions to the F# compiler codebase.
+
+See [the F# Language Specification](https://fsharp.org/specs/language-spec/) for an in-depth description of the F# language. This is essential for understanding some behaviors of the F# compiler and some of the rules within the compiler codebase. For example, the order and way name resolution happens is specified here, which greatly impacts how the code in Name Resolutions works and why certain decisions are made.
 
 ### No contribution is too small
 
@@ -70,12 +76,10 @@ Alternatively, if you _really_ want to live on the bleeding edge, you can set up
 These are the branches in use:
 
 * `main`
-  - Most contributions go here.
+  - Almost all contributions go here.
   - Able to be built, installed and used in the latest public Visual Studio release.
   - May contain updated F# features and logic.
   - Used to build nightly VSIX (see above).
-  - Gets integrated into https://github.com/fsharp/fsharp to form the basis of Mono releases
-  - Gets integrated into https://github.com/fsharp/FSharp.Compiler.Service to form the basis of FSharp.Compiler.Service releases
 
 * `release/dev15.9`
   - Long-term servicing branch for VS 2017 update 15.9.x. We do not expect to service that release, but if we do, that's where the changes will go.
@@ -94,13 +98,6 @@ Evolution of the F# language and core library follows a process spanning two add
 2. Ideas that are "approved in principle" are eligible for a new RFC in the [F# language design repo](https://github.com/fsharp/fslang-design). This is where the technical specification and discussion of approved suggestions go.
 3. Implementations and testing of an RFC are submitted to this repository.
 
-## Additional project documentation
-
-The following links can help you get an overview of some technical aspects of the F# language and compiler:
-
-* [The F# Compiler Technical Guide](https://fsharp.github.io/2015/09/29/fsharp-compiler-guide.html)
-* [The F# Language Specification](https://fsharp.org/specs/language-spec/)
-
 ## License
 
 This project is subject to the MIT License. A copy of this license is in [License.txt](License.txt).

diff --git a/docs/compiler-guide.md b/docs/compiler-guide.md
diff --git a/docsrc/content/caches.fsx → docs/fcs/caches.fsx b/docsrc/content/caches.fsx → docs/fcs/caches.fsx
diff --git a/docsrc/content/compiler.fsx → docs/fcs/compiler.fsx b/docsrc/content/compiler.fsx → docs/fcs/compiler.fsx
diff --git a/docsrc/content/corelib.fsx → docs/fcs/corelib.fsx b/docsrc/content/corelib.fsx → docs/fcs/corelib.fsx
diff --git a/docsrc/content/devnotes.md → docs/fcs/devnotes.md b/docsrc/content/devnotes.md → docs/fcs/devnotes.md
diff --git a/docsrc/content/editor.fsx → docs/fcs/editor.fsx b/docsrc/content/editor.fsx → docs/fcs/editor.fsx
diff --git a/docsrc/content/filesystem.fsx → docs/fcs/filesystem.fsx b/docsrc/content/filesystem.fsx → docs/fcs/filesystem.fsx
diff --git a/docsrc/content/index.md → docs/fcs/index.md b/docsrc/content/index.md → docs/fcs/index.md
diff --git a/docsrc/content/interactive.fsx → docs/fcs/interactive.fsx b/docsrc/content/interactive.fsx → docs/fcs/interactive.fsx
diff --git a/docsrc/content/ja/compiler.fsx → docs/fcs/ja/compiler.fsx b/docsrc/content/ja/compiler.fsx → docs/fcs/ja/compiler.fsx
diff --git a/docsrc/content/ja/corelib.fsx → docs/fcs/ja/corelib.fsx b/docsrc/content/ja/corelib.fsx → docs/fcs/ja/corelib.fsx
diff --git a/docsrc/content/ja/devnotes.md → docs/fcs/ja/devnotes.md b/docsrc/content/ja/devnotes.md → docs/fcs/ja/devnotes.md
diff --git a/docsrc/content/ja/editor.fsx → docs/fcs/ja/editor.fsx b/docsrc/content/ja/editor.fsx → docs/fcs/ja/editor.fsx
diff --git a/docsrc/content/ja/filesystem.fsx → docs/fcs/ja/filesystem.fsx b/docsrc/content/ja/filesystem.fsx → docs/fcs/ja/filesystem.fsx
diff --git a/docsrc/content/ja/index.md → docs/fcs/ja/index.md b/docsrc/content/ja/index.md → docs/fcs/ja/index.md
diff --git a/docsrc/content/ja/interactive.fsx → docs/fcs/ja/interactive.fsx b/docsrc/content/ja/interactive.fsx → docs/fcs/ja/interactive.fsx
diff --git a/docsrc/content/ja/project.fsx → docs/fcs/ja/project.fsx b/docsrc/content/ja/project.fsx → docs/fcs/ja/project.fsx
diff --git a/docsrc/content/ja/symbols.fsx → docs/fcs/ja/symbols.fsx b/docsrc/content/ja/symbols.fsx → docs/fcs/ja/symbols.fsx
diff --git a/docsrc/content/ja/tokenizer.fsx → docs/fcs/ja/tokenizer.fsx b/docsrc/content/ja/tokenizer.fsx → docs/fcs/ja/tokenizer.fsx
diff --git a/docsrc/content/ja/untypedtree.fsx → docs/fcs/ja/untypedtree.fsx b/docsrc/content/ja/untypedtree.fsx → docs/fcs/ja/untypedtree.fsx
diff --git a/docsrc/content/project.fsx → docs/fcs/project.fsx b/docsrc/content/project.fsx → docs/fcs/project.fsx
diff --git a/docsrc/content/queue.fsx → docs/fcs/queue.fsx b/docsrc/content/queue.fsx → docs/fcs/queue.fsx
diff --git a/docsrc/content/react.fsx → docs/fcs/react.fsx b/docsrc/content/react.fsx → docs/fcs/react.fsx
diff --git a/docsrc/content/symbols.fsx → docs/fcs/symbols.fsx b/docsrc/content/symbols.fsx → docs/fcs/symbols.fsx
diff --git a/docsrc/content/tokenizer.fsx → docs/fcs/tokenizer.fsx b/docsrc/content/tokenizer.fsx → docs/fcs/tokenizer.fsx
diff --git a/docsrc/content/typedtree.fsx → docs/fcs/typedtree.fsx b/docsrc/content/typedtree.fsx → docs/fcs/typedtree.fsx
diff --git a/docsrc/content/untypedtree.fsx → docs/fcs/untypedtree.fsx b/docsrc/content/untypedtree.fsx → docs/fcs/untypedtree.fsx
diff --git a/docsrc/files/content/fcs.css → docs/files/content/fcs.css b/docsrc/files/content/fcs.css → docs/files/content/fcs.css
diff --git a/docsrc/files/content/style.ja.css → docs/files/content/style.ja.css b/docsrc/files/content/style.ja.css → docs/files/content/style.ja.css
diff --git a/docsrc/files/images/en.png → docs/files/images/en.png b/docsrc/files/images/en.png → docs/files/images/en.png
diff --git a/docsrc/files/images/ja.png → docs/files/images/ja.png b/docsrc/files/images/ja.png → docs/files/images/ja.png
diff --git a/docsrc/files/images/logo.png → docs/files/images/logo.png b/docsrc/files/images/logo.png → docs/files/images/logo.png
diff --git a/docsrc/tools/generate.fsx → docs/tools/generate.fsx b/docsrc/tools/generate.fsx → docs/tools/generate.fsx
diff --git a/docsrc/tools/generate.ja.fsx → docs/tools/generate.ja.fsx b/docsrc/tools/generate.ja.fsx → docs/tools/generate.ja.fsx
diff --git a/docsrc/tools/templates/ja/template.cshtml → docs/tools/templates/ja/template.cshtml b/docsrc/tools/templates/ja/template.cshtml → docs/tools/templates/ja/template.cshtml
diff --git a/docsrc/tools/templates/template.cshtml → docs/tools/templates/template.cshtml b/docsrc/tools/templates/template.cshtml → docs/tools/templates/template.cshtml