Update documentation configuration (#86)

* Docs configuration

* Update docs/index.md

Co-authored-by: Eirik Tsarpalis <eirik.tsarpalis@gmail.com>

* Update the configuration

* Update docs/docfx.json

Co-authored-by: Eirik Tsarpalis <eirik.tsarpalis@gmail.com>

* Update config

* Update icons, use Makefile, remove warnings

* Use a link that passes markdown link validation

* remove working directory

---------

Co-authored-by: Eirik Tsarpalis <eirik.tsarpalis@gmail.com>

Makefile

@@ -0,0 +1,38 @@
+SOURCE_DIRECTORY := $(dir $(realpath $(lastword $(MAKEFILE_LIST))))
+ARTIFACT_PATH := $(SOURCE_DIRECTORY)artifacts
+DOCS_PATH := $(SOURCE_DIRECTORY)docs
+CONFIGURATION ?= Release
+
+clean:
+	dotnet clean
+	rm -rf $(ARTIFACT_PATH)/*
+	rm -rf $(DOCS_PATH)/api
+
+restore:
+	dotnet tool restore
+	dotnet restore
+
+build: restore
+	dotnet build --no-restore --configuration $(CONFIGURATION)
+
+test: build
+	dotnet test \
+		--no-build \
+		--configuration $(CONFIGURATION) \
+		--filter '(Execution!=Manual)' \
+		--blame \
+		--diag "$(ARTIFACT_PATH)/diag.txt" \
+		--logger "trx" \
+		--collect "Code Coverage;Format=cobertura" \
+		--results-directory $(ARTIFACT_PATH)/test-results \
+		-- \
+		RunConfiguration.CollectSourceInformation=true
+
+generate-docs: clean restore
+	dotnet build --no-restore --configuration Release
+	dotnet docfx $(DOCS_PATH)/docfx.json
+
+serve-docs: generate-docs
+	dotnet docfx serve $(ARTIFACT_PATH)/_site --port 8080
+
+.DEFAULT_GOAL := build