add base doc site

Author: rickdotnet

docs/.gitignore

@@ -0,0 +1 @@
+/_site

docs/api/.gitignore

@@ -0,0 +1,5 @@
+###############
+#  temp file  #
+###############
+*.yml
+.manifest

docs/api/index.md

@@ -0,0 +1,5 @@
+# API Documentation
+
+You can browse the latest jwt.net API Documentation[^1] [here](NATS.Jwt.yml).
+
+[^1]: API Documentation is auto-generated using [DocFX](https://dotnet.github.io/docfx/).

docs/docfx.json

@@ -0,0 +1,65 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [ "**/*.csproj" ],
+          "src": "../src"
+        }
+      ],
+      "dest": "api",
+      "includePrivateMembers": false,
+      "disableGitFeatures": false,
+      "disableDefaultFilter": false,
+      "noRestore": false,
+      "namespaceLayout": "nested",
+      "memberLayout": "separatePages",
+      "allowCompilationErrors": false
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/index.md"
+        ]
+      },
+      {
+        "files": [
+          "documentation/**.md",
+          "documentation/**/toc.yml",
+          "toc.yml",
+          "*.md"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "images/**"
+        ]
+      }
+    ],
+    "output": "_site",
+    "globalMetadataFiles": [],
+    "fileMetadataFiles": [],
+    "template": [
+      "default",
+      "modern",
+      "nats_template"
+    ],
+    "postProcessors": [],
+    "keepFileLink": false,
+    "disableGitFeatures": false,
+    "markdownEngineName": "markdig",
+    "markdownEngineProperties": {
+        "markdigExtensions": [
+            "abbreviations",
+            "definitionlists",
+            "tasklists",
+            "footnotes"
+        ]
+    }
+  }
+}

docs/documentation/intro.md

@@ -0,0 +1,26 @@
+# Introduction
+
+This is a .NET implementation of the JWT library for the NATS ecosystem.
+
+A [JWT](https://jwt.io/) implementation that uses [nkeys](https://github.com/nats-io/nkeys.net) to digitally sign
+JWT tokens for the [NATS](https://nats.io/) ecosystem.
+
+See also https://github.com/nats-io/jwt
+
+## Installation
+
+Reference [Jwt.net NuGet package](https://www.nuget.org/packages/jwt.net) in your project:
+You can install the package via NuGet:
+
+```bash
+dotnet add package NATS.Jwt --prerelease
+```
+
+## Usage
+
+[!code-csharp[](../../tests/NATS.Jwt.DocsExamples/IntroPage.cs#nats-jwt)]
+
+
+## What's Next
+
+*Documentation is in progress.* Help us improve the documentation by contributing today!

docs/documentation/toc.yml

@@ -0,0 +1,5 @@
+- name: Introduction
+  href: intro.md
+
+- name: Updating Documentation
+  href: update-docs.md

docs/documentation/update-docs.md

@@ -0,0 +1,24 @@
+# Updating Documentation
+
+As well as being able to edit pages on GitHub, you can also edit and update this documentation,
+view locally and submit a Pull Request to be included in this documentation site.
+
+## Running DocFX locally
+
+You mush have [DocFX installed](https://dotnet.github.io/docfx/):
+Clone the jwt.net ([nats-io/jwt.net](https://github.com/nats-io/jwt.net)) repository, then `cd docs` and run local server (`docfx --serve`) to view this documentation site.
+
+```
+dotnet tool update -g docfx
+```
+
+Generate API documentation and run local server:
+```
+git clone https://github.com/nats-io/jwt.net.git
+cd jwt.net/docs
+docfx --serve
+```
+
+You might not be a .NET developer, but still want to contribute to the documentation.
+You can install the .NET SDK and use the `docfx` tool to generate the documentation.
+Download the .NET SDK from [dot.net](https://dot.net).

docs/index.md

@@ -0,0 +1,26 @@
+# Introduction
+
+This is a .NET implementation of the JWT library for the NATS ecosystem.
+
+A [JWT](https://jwt.io/) implementation that uses [nkeys](https://github.com/nats-io/nkeys.net) to digitally sign
+JWT tokens for the [NATS](https://nats.io/) ecosystem.
+
+See also https://github.com/nats-io/jwt
+
+## Installation
+
+Reference [Jwt.net NuGet package](https://www.nuget.org/packages/jwt.net) in your project:
+You can install the package via NuGet:
+
+```bash
+dotnet add package NATS.Jwt --prerelease
+```
+
+## Usage
+
+[!code-csharp[](../tests/NATS.Jwt.DocsExamples/IntroPage.cs#nats-jwt)]
+
+
+## What's Next
+
+*Documentation is in progress.* Help us improve the documentation by contributing today!