fix ClimaCoreMakie doc generation

Author: juliasloan25

docs/Project.toml

@@ -12,5 +12,6 @@ FFTW = "7a1cc6ca-52ef-59f5-83cd-3a7055c09341"
 IntervalSets = "8197267c-284f-5f27-9208-e0e47529a953"
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
 Literate = "98b081ad-f1c9-55d3-8b20-4c87d4299306"
+Makie = "ee78f7c6-11fb-53f2-987a-cfe4a2b5a57a"
 OrdinaryDiffEqSSPRK = "669c94d9-1f4b-4b64-b377-1aa079aa2388"
 Plots = "91a5bcdd-55d7-5caf-9e0b-520d859cae80"

docs/make.jl

@@ -5,6 +5,7 @@ import ClimaCore,
     ClimaCorePlots,
     ClimaCoreTempestRemap,
     ClimaCoreSpectra
+using Makie  # Required for Documenter to resolve @ref links to Makie types in ClimaCoreMakie docs
 
 if !@isdefined(TUTORIALS)
     TUTORIALS = ["introduction"]
@@ -60,6 +61,7 @@ withenv("GKSwstype" => "nul") do
         sitename = "ClimaCore.jl",
         format = format,
         checkdocs = :exports,
+        warnonly = [:cross_references],  # Warn instead of error on unresolved @ref links (e.g., Makie.Linestyle)
         clean = true,
         doctest = true,
         modules = [

docs/src/lib/ClimaCoreMakie.md

@@ -8,5 +8,12 @@ ClimaCoreMakie.jl provides functionality for plotting ClimaCore fields extending
 
 ```@docs
 fieldheatmap
+fieldheatmap!
+FieldHeatmap
 fieldcontourf
+fieldcontourf!
+FieldContourf
+fieldline
+fieldline!
+FieldLine
 ```

lib/ClimaCoreMakie/src/fieldline.jl

@@ -1,3 +1,20 @@
+"""
+    fieldline(field)
+
+Plots a line plot of a 1D field.
+
+## Attributes
+
+Inherited from [`Makie.lines`](https://docs.makie.org/stable/examples/plotting_functions/lines/index.html#lines).
+
+- `color` sets the color of the line.
+
+- `linewidth` sets the width of the line.
+
+- `linestyle` sets the style of the line (e.g., `:solid`, `:dash`, `:dot`).
+
+See the [Makie.lines documentation](https://docs.makie.org/stable/examples/plotting_functions/lines/index.html#lines) for a complete list of attributes.
+"""
 @recipe FieldLine (field,) begin
     Makie.documented_attributes(Makie.Lines)...
 end