documentation init with docfx

.travis.yml

@@ -1,10 +1,39 @@
 language: csharp
 dist: xenial
 mono: none
-dotnet: 3.0
-solution: "./src/DotNetStac.sln"
-install:
-- dotnet restore src/
-script:
-- dotnet build src/
-- dotnet test src/DotNetStac.Test
+dotnet: 3.1
+jobs:
+  include:
+    - stage: "Build"
+      if: branch != master OR branch != docs
+      solution: "./src/DotNetStac.sln"
+      install: dotnet restore src/
+      script: dotnet build src/
+    - stage: "Generate Documentation"
+      if: branch = master OR branch = docs
+      install:
+        - dotnet restore
+        - nuget install docfx.console -Version 2.51.0
+      script:
+        - ./docfx.console.2.51.0/tools/docfx.exe metadata docfx_project/docfx.json
+        - ./docfx.console.2.51.0/tools/docfx.exe build docfx_project/docfx.json
+      deploy:
+        provider: pages
+        skip_cleanup: true
+        github_token: $GITHUB_TOKEN
+        keep_history: true
+        local_dir: docs/_site
+        on:
+          branch: master
+    - stage: "Run Tests"
+      if: branch != master OR branch != docs
+      install: dotnet restore
+      script: dotnet test src/DotNetStac.Test/DotNetStac.Test.csproj --verbosity detailed
+    - stage: "Publish to NuGet"
+      if: branch = master
+      install: dotnet restore
+      script: 
+        - dotnet build
+        - dotnet publish -c release
+        - dotnet pack -c release --include-symbols -o publish
+        - dotnet nuget push publish/*.nupkg --skip-duplicate -k $NUGET_TOKEN -s https://api.nuget.org/v3/index.json

docs/.gitignore

@@ -0,0 +1,9 @@
+###############
+#    folder   #
+###############
+/**/DROP/
+/**/TEMP/
+/**/packages/
+/**/bin/
+/**/obj/
+_site

docs/api/.gitignore

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

docs/api/index.md

@@ -0,0 +1,2 @@
+# PLACEHOLDER
+TODO: Add .NET projects to the *src* folder and run `docfx` to generate **REAL** *API Documentation*!

docs/articles/intro.md

@@ -0,0 +1 @@
+# Add your introductions here!

docs/articles/toc.yml

@@ -0,0 +1,2 @@
+- name: Introduction
+  href: intro.md

docs/docfx.json

@@ -0,0 +1,68 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "**/**.csproj"
+          ],
+          "exclude": [
+            "*Test*/**.csproj"
+          ],
+          "src": ".."
+        }
+      ],
+      "dest": "api",
+      "disableGitFeatures": false,
+      "disableDefaultFilter": false
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/index.md"
+        ]
+      },
+      {
+        "files": [
+          "articles/**.md",
+          "articles/**/toc.yml",
+          "toc.yml",
+          "*.md"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "images/**"
+        ]
+      }
+    ],
+    "overwrite": [
+      {
+        "files": [
+          "apidoc/**.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "dest": "_site",
+    "globalMetadataFiles": [],
+    "fileMetadataFiles": [],
+    "template": [
+      "default"
+    ],
+    "postProcessors": [],
+    "markdownEngineName": "markdig",
+    "noLangKeyword": false,
+    "keepFileLink": false,
+    "cleanupCacheHistory": false,
+    "disableGitFeatures": false
+  }
+}

docs/index.md

@@ -0,0 +1,4 @@
+# This is the **HOMEPAGE**.
+Refer to [Markdown](http://daringfireball.net/projects/markdown/) for how to write markdown files.
+## Quick Start Notes:
+1. Add images to the *images* folder if the file is referencing an image.

docs/toc.yml

@@ -0,0 +1,5 @@
+- name: Articles
+  href: articles/
+- name: Api Documentation
+  href: api/
+  homepage: api/index.md