docs: Provide a new documentation template (#144)

* Provide a new documentation template

* 💚 add netlify config

* ✨ update docs

* 🐛 deploy preview index.html fix

* 👌 Fix docs + netlify app ID

Author: Mcalewaert

.gitignore

@@ -222,7 +222,7 @@ ClientBin/
 *.publishsettings
 orleans.codegen.cs
 
-# Including strong name files can present a security risk 
+# Including strong name files can present a security risk
 # (https://github.com/github/gitignore/pull/2483#issue-259490424)
 #*.snk
 
@@ -318,7 +318,7 @@ __pycache__/
 # OpenCover UI analysis results
 OpenCover/
 
-# Azure Stream Analytics local run output 
+# Azure Stream Analytics local run output
 ASALocalRun/
 
 # MSBuild Binary and Structured Log
@@ -327,10 +327,15 @@ ASALocalRun/
 # NVidia Nsight GPU debugger configuration file
 *.nvuser
 
-# MFractors (Xamarin productivity tool) working folder 
+# MFractors (Xamarin productivity tool) working folder
 .mfractor/
 **/Open-Api-Docs.xml
 /docs/_site
 **/docker-compose.override.yml
 **/appsettings.Development.json
 **/appsettings.local.json
+
+# Docusaurus
+docs/.docusaurus
+docs/node_modules
+docs/build

docs/CNAME

@@ -1,8 +1,52 @@
-Documentation
-====
+# Website
 
-All documentation for Arcus Event Grid Proxy which are published via GitHub Pages with Jekyll.
+This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
 
-## Running Jekyll locally
+## Prerequisites
+This documentation assumes that you run all scripts within the docs folder.
 
-Running Jekyll locally to test your changes is super easy, learn more about it [here](https://jekyllrb.com/docs/#instructions).
+```console
+cd docs
+```
+
+## Installation
+
+```console
+npm install
+```
+
+## Local Development
+
+```console
+npm start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Versioning
+https://docusaurus.io/docs/versioning
+
+You can use the version script to create a new documentation version based on the latest content in the `./preview` directory. That specific set of documentation will then be preserved and accessible even as the documentation in the docs directory changes moving forward.
+
+### Tagging a new version
+
+1. First, make sure your content in the `./preview` directory is ready to be frozen as a version. A version always should be based from master.
+2. Enter a new version number: 
+   
+`npm run docusaurus docs:version 1.1.0`
+
+---
+When tagging a new version, the document versioning mechanism will:
+
+- Copy the full `./preview` folder contents into a new `versioned_docs/version-<version>/` folder.
+- Create a versioned sidebars file based from your current sidebar configuration (if it exists) - saved as `versioned_sidebars/version-<version>-sidebars.json`.
+- Append the new version number to `versions.json`.
+
+## Syntax higlighting
+
+To have syntax highlighting within the codeblocks you have to use one of the prism supported languages:
+
+https://github.com/FormidableLabs/prism-react-renderer/blob/master/src/vendor/prism/includeLangs.js
+## Deploying to Netlify
+
+https://docusaurus.io/docs/deployment#deploying-to-netlify