DROP ME: simplify docs build

Author: giordano

.github/workflows/Documentation.yml

@@ -25,7 +25,7 @@ concurrency:
   # git-push to the same branch, so we want to avoid clashes.  NOTE: this is
   # different from the concurrency group below, which is to cancel successive
   # jobs from within the PR.
-  group: docs-pushing
+  group: docs-pushing-1
 
 jobs:
   build:
@@ -45,7 +45,7 @@ jobs:
       - uses: actions/checkout@v5
       - uses: julia-actions/setup-julia@v2
         with:
-          version: "min"
+          version: "1.12"
       - uses: julia-actions/cache@v2
         id: julia-cache
       - uses: actions/create-github-app-token@v2
@@ -58,6 +58,8 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
           DOCUMENTER_KEY: ${{ secrets.BREEZEDOCUMENTATION_DOCUMENTER_KEY }}
+          JULIA_DEBUG: Documenter
+          ACTIONS_RUNNER_DEBUG: true
       - name: Save Julia depot cache on cancel or failure
         id: julia-cache-save
         if: cancelled() || failure()

docs/Project.toml

@@ -1,10 +1,9 @@
 [deps]
-CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
-DocumenterCitations = "daee34ce-89f3-4625-b898-19384cb65244"
 Oceananigans = "9e8cae18-63c1-5223-a75c-80ca9d6e9a09"
 
 [compat]
-CairoMakie = "0.13, 0.14"
 Documenter = "1"
-DocumenterCitations = "1.4"
+
+[sources]
+Documenter = {url = "https://github.com/giordano/documenter.jl", rev = "mg/post-github-status-deploydoc"}

docs/make.jl

@@ -1,27 +1,31 @@
 using Breeze
 using Documenter
-using DocumenterCitations
+# using DocumenterCitations
 
-using CairoMakie
-CairoMakie.activate!(type = "svg")
-set_theme!(Theme(linewidth = 3))
+# using CairoMakie
+# CairoMakie.activate!(type = "svg")
+# set_theme!(Theme(linewidth = 3))
 
-DocMeta.setdocmeta!(Breeze, :DocTestSetup, :(using Breeze); recursive=true)
+# DocMeta.setdocmeta!(Breeze, :DocTestSetup, :(using Breeze); recursive=true)
 
-bib_filepath = joinpath(dirname(@__FILE__), "src", "breeze.bib")
-bib = CitationBibliography(bib_filepath, style=:authoryear)
+# bib_filepath = joinpath(dirname(@__FILE__), "src", "breeze.bib")
+# bib = CitationBibliography(bib_filepath, style=:authoryear)
 
-makedocs(sitename="Breeze",
-    plugins = [bib],
+makedocs(
+    ;
+    doctest = false,
+    warnonly = true,
+    sitename="Breeze",
+    # plugins = [bib],
     pages=[
         "Home" => "index.md",
-        "Thermodynamics" => "thermodynamics.md",
-        "Microphysics" => Any[
-            "Overview" => "microphysics/microphysics_overview.md",
-            "Warm phase saturation adjustment" => "microphysics/saturation_adjustment.md",
-        ],
-        "References" => "references.md",
-        "API" => "api.md",
+        # "Thermodynamics" => "thermodynamics.md",
+        # "Microphysics" => Any[
+        #     "Overview" => "microphysics/microphysics_overview.md",
+        #     "Warm phase saturation adjustment" => "microphysics/saturation_adjustment.md",
+        # ],
+        # "References" => "references.md",
+        # "API" => "api.md",
     ]
 )
 

docs/src/api.md

@@ -11,7 +11,7 @@ Breeze provides two ways to simulate moist atmospheres:
 
 * A [`MoistAirBuoyancy`](@ref) that can be used with [Oceananigans](https://clima.github.io/OceananigansDocumentation/stable/)' [`NonhydrostaticModel`](https://clima.github.io/OceananigansDocumentation/stable/appendix/library/#Oceananigans.Models.NonhydrostaticModels.NonhydrostaticModel-Tuple{}) to simulate atmospheric flows with the Boussinesq approximation.
 
-* A prototype [`AtmosphereModel`](@ref Breeze.AtmosphereModels.AtmosphereModel) that uses the anelastic approximation following [Pauluis2008](@citet).
+* A prototype [`AtmosphereModel`](@ref Breeze.AtmosphereModels.AtmosphereModel) that uses the anelastic approximation following Pauluis2008.
 
 ## Installation
 
@@ -26,7 +26,7 @@ Pkg.add("https://github.com/NumericalEarth/Breeze.jl.git")
 
 A basic free convection simulation:
 
-```@example intro
+```julia
 using Oceananigans
 using Oceananigans.Units
 using CairoMakie