feat: adding github doc generation and hosting

.github/workflows/documentation.yml

@@ -0,0 +1,28 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - main
+    tags: '*'
+  pull_request:
+
+jobs:
+  build:
+    permissions:
+      actions: write
+      contents: write
+      pull-requests: read
+      statuses: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
+        with:
+          version: '1'
+      - name: Install dependencies
+        run: julia --project=docs -e 'using Pkg; Pkg.instantiate()'
+      - name: Build and deploy
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: julia --project=docs docs/make.jl

docs/Manifest.toml

@@ -2,7 +2,7 @@
 
 julia_version = "1.10.2"
 manifest_format = "2.0"
-project_hash = "aa51543ac8436e6e88020ded35ef6ec1e89249e9"
+project_hash = "ee0b825d6c8d38e0f5069b494fc43cb1a07f8411"
 
 [[deps.ANSIColoredPrinters]]
 git-tree-sha1 = "574baf8110975760d391c710b6341da1afa48d8c"
@@ -364,9 +364,9 @@ version = "0.9.3"
 
 [[deps.Documenter]]
 deps = ["ANSIColoredPrinters", "AbstractTrees", "Base64", "CodecZlib", "Dates", "DocStringExtensions", "Downloads", "Git", "IOCapture", "InteractiveUtils", "JSON", "LibGit2", "Logging", "Markdown", "MarkdownAST", "Pkg", "PrecompileTools", "REPL", "RegistryInstances", "SHA", "TOML", "Test", "Unicode"]
-git-tree-sha1 = "76deb8c15f37a3853f13ea2226b8f2577652de05"
+git-tree-sha1 = "5a1ee886566f2fa9318df1273d8b778b9d42712d"
 uuid = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
-version = "1.5.0"
+version = "1.7.0"
 
 [[deps.Downloads]]
 deps = ["ArgTools", "FileWatching", "LibCURL", "NetworkOptions"]

docs/Project.toml

@@ -2,3 +2,6 @@
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 InformativeSampling = "bfd01cc8-db36-4de5-b056-8ab04eef9441"
 InformativeSamplingUtils = "1d6b69be-e25c-46ac-b1c5-442f720809e4"
+
+[compat]
+Documenter = "1.7"

docs/make.jl

@@ -7,8 +7,8 @@ using InformativeSampling: Maps, Missions, BeliefModels, Kernels,
 using InformativeSamplingUtils: DataIO, Visualization, Metrics
 
 makedocs(
-    sitename="InformativeSampling.jl",
-    remotes=nothing,
+    sitename="InformativeSampling",
+    # remotes=nothing,
     pages = [
         "index.md",
         "application.md",
@@ -19,3 +19,8 @@ makedocs(
     ],
     format = Documenter.HTML(prettyurls=false)
 )
+
+deploydocs(
+    repo = "github.com/ngharrison/InformativeSampling.git",
+    versions = nothing,
+)

readme.org

@@ -147,6 +147,8 @@ Note that just the same as when running Julia code normally, if the interpreter
 
 * Documentation
 
+The docs can be viewed at https://ngharrison.github.io/InformativeSampling/.
+
 If you want to view the docs locally, first generate them by running the following command(s) from the project root:
 
 #+begin_src shell