Doc updates to address #898 (#899)

* bump version

* add explicit docs about the read-only nature of the repo

also add contributing, issue template, and pr template to drive that point home

* rever weird version changes

Author: baronfel

.github/issue_template.md

@@ -0,0 +1,5 @@
+# FSharp.Compiler.Service Issue Template
+
+> Thanks for your intention to help out!
+
+We appreciate your enthusiasm, but this repository is a *read-only* fork of the official F# compiler. Please raise your issue at the [upstream repo](https://github.com/microsoft/visualfsharp/issues/new).

.github/pull_request_template.md

@@ -0,0 +1,5 @@
+# FSharp.Compiler.Service PR Template
+
+> Thanks for your intention to help out!
+
+We appreciate your enthusiasm, but this repository is a *read-only* fork of the official F# compiler. Please raise your Pull Request at the [upstream repo](https://github.com/microsoft/visualfsharp/compare).

CONTRIBUTING.md

@@ -0,0 +1,5 @@
+# Contributing to FSharp.Compiler.Service
+
+> Thanks for your intention to help out!
+
+We appreciate your enthusiasm, but this repository is a *read-only* fork of the official F# compiler. If you have issues, contributions, or questions, please raise them at the [upstream repo](https://github.com/microsoft/visualfsharp).

README.md

@@ -1,21 +1,34 @@
-F# Compiler Service
-===================
+# F# Compiler Service
 
-The F# compiler services package contains a custom build of the F# compiler that
+The FSharp.Compiler.Service package contains a custom build of the F# compiler that
 exposes additional functionality for implementing F# language bindings, additional
 tools based on the compiler or refactoring tools. The package also includes F#
-interactive service that can be used for embedding F# scripting into your applications.
+interactive service that can be used for embedding F# scripting into your applications. This repository exists entirely to create and publish that package.
 
-Documentation
--------------
+## Purpose
+
+> This repo is (mostly) **read only**
+
+This repo exists as a downstream packaging repository for the [FSharp.Compiler.Service](https://www.nuget.org/packages/FSharp.Compiler.Service) NuGet Package. It serves the following purposes _only_:
+
+* Release packaging
+* Hosting [public documentation](http://fsharp.github.io/FSharp.Compiler.Service/)
+* Serving as a stable base for Fable
+
+
+It is a fork of the official F# source repository, which is located at [microsoft/visualfsharp](https://github.com/microsoft/visualfsharp). **All** issues and contributions should be raised there. All feature development should be targeted there. Once contributions are accepted into [microsoft/visualfsharp](https://github.com/microsoft/visualfsharp), they will be integrated into this repository for packaging and release.
+
+If you need to add customizations to FSharp.Compiler.Service for your own uses, you should clone [microsoft/visualfsharp](https://github.com/microsoft/visualfsharp) and build the FSharp.Compiler.Service binaries from there. The process is exactly the same as it is described below.
+
+
+## Documentation
 
 For more information about the project, see:
 
- * [F# Compiler Service documentation](http://fsharp.github.io/FSharp.Compiler.Service/)
- * [Developer notes explain the project structure](http://fsharp.github.io/FSharp.Compiler.Service/devnotes.html)
+ * [F# Compiler Service API and usage documentation](http://fsharp.github.io/FSharp.Compiler.Service/)
+ * [Description of the project structure](http://fsharp.github.io/FSharp.Compiler.Service/devnotes.html)
 
-Build and Test
------
+## Build and Test
 
 On Windows:
 
@@ -25,21 +38,21 @@ On Linux:
 
     ./fcs/build.sh Test
 
-Packages:
+To build NuGet packages:
 
     build NuGet
     build TestAndNuGet
 
+## Build Status
 
-Build Status
-------------
-
-Head (branch ``master``):
+Branch | OS | Badge |
+------ | ------ | - |
+master | Linux/OSX | [![Build Status](https://travis-ci.org/fsharp/FSharp.Compiler.Service.svg?branch=master)](https://travis-ci.org/fsharp/FSharp.Compiler.Service) |
+master | Windows | [![Build status](https://ci.appveyor.com/api/projects/status/3yllu2qh19brk61d?svg=true)](https://ci.appveyor.com/project/fsgit/fsharp-compiler-service)  |
 
- * Linux/OSX: [![Build Status](https://travis-ci.org/fsharp/FSharp.Compiler.Service.svg?branch=master)](https://travis-ci.org/fsharp/FSharp.Compiler.Service)
- * Windows: [![Build status](https://ci.appveyor.com/api/projects/status/3yllu2qh19brk61d?svg=true)](https://ci.appveyor.com/project/fsgit/fsharp-compiler-service) 
+## NuGet package
 
-NuGet  [![NuGet Badge](https://buildstats.info/nuget/FSharp.Compiler.Service)](https://www.nuget.org/packages/FSharp.Compiler.Service)
+[![NuGet Badge](https://buildstats.info/nuget/FSharp.Compiler.Service)](https://www.nuget.org/packages/FSharp.Compiler.Service)
 
 Stable builds are available in the NuGet Gallery:
 [https://www.nuget.org/packages/FSharp.Compiler.Service](https://www.nuget.org/packages/FSharp.Compiler.Service)
@@ -48,17 +61,16 @@ All AppVeyor builds are available using the NuGet feed: https://ci.appveyor.com/
 
 If using Paket, add the source at the top of `paket.dependencies`.
 
-License
------------
+## License
 
 This project is subject to the MIT License. A copy of this license can be found in [License.txt](License.txt) at the root of this repo.
 
-Maintainers
------------
+## Maintainers
 
 The maintainers of this repository are:
 
  - [Don Syme](http://github.com/dsyme)
  - [Tomas Petricek](http://github.com/tpetricek)
  - [Enrico Sada](http://github.com/enricosada)
+ - [Chet Husk](http://github.com/baronfel)
  - Many people have helped including [Robin Neatherway](https://github.com/rneatherway), [Dave Thomas](http://github.com/7sharp9), [Lincoln Atkinson](http://github.com/latkin), [Kevin Ransom](http://github.com/KevinRansom), [Vladimir Matveev](http://github.com/vladima) and others