Update to Documenter.jl v1 (#364)

Author: giordano

.github/workflows/Documentation.yml

@@ -0,0 +1,43 @@
+name: Documentation
+
+on:
+  push:
+    branches: "master"
+    tags: ["*"]
+    paths:
+      - '.github/workflows/Documentation.yml'
+      - '*.toml'
+      - 'docs/**'
+      - 'src/**'
+  pull_request:
+    paths:
+      - '.github/workflows/Documentation.yml'
+      - '*.toml'
+      - 'docs/**'
+      - 'src/**'
+  release:
+
+concurrency:
+  # Skip intermediate builds: always.
+  # Cancel intermediate builds: always.
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  BINARYBUILDER_AUTOMATIC_APPLE: true
+
+jobs:
+  Documentation:
+    timeout-minutes: 30
+    runs-on: ubuntu-latest
+    env:
+      JULIA_PKG_SERVER: ""
+    steps:
+      - uses: actions/checkout@v4
+      - uses: julia-actions/cache@v1
+      - uses: julia-actions/setup-julia@v1
+        with:
+          version: "1.7"
+      - uses: julia-actions/julia-docdeploy@releases/v1
+        env:
+          DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}

.github/workflows/PreviewsCleanup.yml

@@ -0,0 +1,26 @@
+name: Doc Preview Cleanup
+
+on:
+  pull_request:
+    types: [closed]
+
+jobs:
+  doc-preview-cleanup:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout gh-pages branch
+        uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+      - name: Delete preview and history + push changes
+        run: |
+            if [ -d "previews/PR$PRNUM" ]; then
+              git config user.name "Documenter.jl"
+              git config user.email "documenter@juliadocs.github.io"
+              git rm -rf "previews/PR$PRNUM"
+              git commit -m "delete preview"
+              git branch gh-pages-new $(echo "delete history" | git commit-tree HEAD^{tree})
+              git push --force origin gh-pages-new:gh-pages
+            fi
+        env:
+            PRNUM: ${{ github.event.number }}

.github/workflows/ci.yml

@@ -4,7 +4,17 @@ on:
   push:
     branches: "master"
     tags: ["*"]
+    paths:
+      - '.github/workflows/ci.yml'
+      - '*.toml'
+      - 'src/**'
+      - 'test/**'
   pull_request:
+    paths:
+      - '.github/workflows/ci.yml'
+      - '*.toml'
+      - 'src/**'
+      - 'test/**'
   release:
 
 concurrency:
@@ -94,18 +104,3 @@ jobs:
         continue-on-error: true
       - uses: julia-actions/julia-uploadcoveralls@v1.0
         continue-on-error: true
-
-  Documentation:
-    timeout-minutes: 30
-    runs-on: ubuntu-latest
-    env:
-      JULIA_PKG_SERVER: ""
-    steps:
-      - uses: actions/checkout@v4
-      - uses: julia-actions/cache@v1
-      - uses: julia-actions/setup-julia@latest
-        with:
-          version: "1.7"
-      - uses: julia-actions/julia-docdeploy@releases/v1
-        env:
-          DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}

docs/Project.toml

@@ -2,4 +2,4 @@
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 
 [compat]
-Documenter = "~0.24"
+Documenter = "1"

docs/src/index.md

@@ -8,13 +8,22 @@ This is the reference documentation of
 ```
 
 ## Types
+
 ```@autodocs
 Modules = [BinaryBuilderBase]
 Order = [:type]
 ```
 
 ## Functions
+
 ```@autodocs
 Modules = [BinaryBuilderBase]
 Order = [:function]
 ```
+
+## Constants
+
+```@autodocs
+Modules = [BinaryBuilderBase]
+Order = [:constant]
+```