doc: fix details blocks

docs/src/manual.md

@@ -58,36 +58,36 @@ all the functions and types exported by the component packages. This is the
 A wrapper around the GBIF API, to retrieve taxa and occurrence datasets, and
 perform filtering on these occurrence data based on flags.
 
-![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=GBIF-*&style=flat-square&label=GBIF.jl) [![DOC](https://img.shields.io/badge/Manual-teal?style=flat-square)](https://poisotlab.github.io/SpeciesDistributionToolkit.jl/GBIF/) ![Lifecycle:Stable](https://img.shields.io/badge/Lifecycle-Stable-97ca00?style=flat-square)
+![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=GBIF-*&style=flat-square&label=GBIF.jl) ![Lifecycle:Stable](https://img.shields.io/badge/Lifecycle-Stable-97ca00?style=flat-square)
 
 ### Getting environmental data: `SimpleSDMDatasets.jl`
 
 An efficient way to download and store environmental raster data for consumption
 by other packages.
 
-![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=SimpleSDMDatasets-*&style=flat-square&label=SimpleSDMDatasets.jl) [![DOC](https://img.shields.io/badge/Manual-teal?style=flat-square)](https://poisotlab.github.io/SpeciesDistributionToolkit.jl/SimpleSDMDatasets/) ![Lifecycle:Stable](https://img.shields.io/badge/Lifecycle-Stable-97ca00?style=flat-square)
+![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=SimpleSDMDatasets-*&style=flat-square&label=SimpleSDMDatasets.jl) ![Lifecycle:Stable](https://img.shields.io/badge/Lifecycle-Stable-97ca00?style=flat-square)
 
 ### Using environmental data: `SimpleSDMLayers.jl`
 
 A series of types and common operations on raster data.
 
-![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=SimpleSDMLayers-*&style=flat-square&label=SimpleSDMLayers.jl) [![DOC](https://img.shields.io/badge/Manual-teal?style=flat-square)](https://poisotlab.github.io/SpeciesDistributionToolkit.jl/SimpleSDMLayers/) ![Lifecycle:Maturing](https://img.shields.io/badge/Lifecycle-Maturing-007EC6?style=flat-square)
+![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=SimpleSDMLayers-*&style=flat-square&label=SimpleSDMLayers.jl) ![Lifecycle:Maturing](https://img.shields.io/badge/Lifecycle-Maturing-007EC6?style=flat-square)
 
 ### Simulating occurrence data: `Fauxcurrences.jl`
 
 A package to simulate realistic species occurrence data from a know series of
 occurrences, with additional statistical constraints.
 
-![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=Fauxcurrences-*&style=flat-square&label=Fauxcurrences.jl) [![DOC](https://img.shields.io/badge/Manual-teal?style=flat-square)](https://poisotlab.github.io/SpeciesDistributionToolkit.jl/Fauxcurrences/) ![Lifecycle:Maturing](https://img.shields.io/badge/Lifecycle-Maturing-007EC6?style=flat-square)
+![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=Fauxcurrences-*&style=flat-square&label=Fauxcurrences.jl) ![Lifecycle:Maturing](https://img.shields.io/badge/Lifecycle-Maturing-007EC6?style=flat-square)
 
 ### Getting organisms silhouettes: `Phylopic.jl`
 
 A wrapper around the Phylopic API.
 
-![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=Phylopic-*&style=flat-square&label=Phylopic.jl) [![DOC](https://img.shields.io/badge/Manual-teal?style=flat-square)](https://poisotlab.github.io/SpeciesDistributionToolkit.jl/Phylopic/) ![Lifecycle:Stable](https://img.shields.io/badge/Lifecycle-Stable-97ca00?style=flat-square)
+![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=Phylopic-*&style=flat-square&label=Phylopic.jl) ![Lifecycle:Stable](https://img.shields.io/badge/Lifecycle-Stable-97ca00?style=flat-square)
 
 ### Teaching and workshops: `SDeMo.jl`
 
 A series of very simple SDMs and utility functions for education.
 
-![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=SDeMo-*&style=flat-square&label=GBIF.jl) [![DOC](https://img.shields.io/badge/Manual-teal?style=flat-square)](https://poisotlab.github.io/SpeciesDistributionToolkit.jl/SDeMo/) ![Lifecycle:Maturing](https://img.shields.io/badge/Lifecycle-Maturing-007EC6?style=flat-square)
+![GitHub Release](https://img.shields.io/github/v/release/poisotlab/speciesdistributiontoolkit.jl?filter=SDeMo-*&style=flat-square&label=SDeMo.jl) ![Lifecycle:Maturing](https://img.shields.io/badge/Lifecycle-Maturing-007EC6?style=flat-square)

docs/src/tutorials/fauxcurrences.jl

@@ -242,7 +242,8 @@ scatter!(ax3, bin_s_intra[3], color=:transparent, strokewidth=2, strokecolor=:or
 [hidedecorations!(ax) for ax in [ax1, ax2, ax3]]
 current_figure() #hide
 
-# For the components of the inter-specific distance matrix, this looks like:
+# For the components of the inter-specific distance matrix, this gives the
+# following plot:
 
 # fig-distances-inter
 f = Figure(; size=(700, 250))

docs/src/tutorials/polygons.jl

@@ -57,15 +57,17 @@ layer = SDMLayer(
 heatmap(layer; colormap = :navia, axis = (; aspect = DataAspect()))
 current_figure() #hide
 
-# We can now mask this layer according to the polygon:
+# We can now mask this layer according to the polygon. This uses the same
+# `mask!` method we use when masking with another layer:
 
 mask!(layer, CHE)
 
 # fig-region-masked
 heatmap(layer; colormap = :navia, axis = (; aspect = DataAspect()))
 current_figure() #hide
 
-# This is a much larger layer than we need! For this reason, we will trim it so that the empty areas are removed:
+# This is a much larger layer than we need! For this reason, we will trim it so
+# that the empty areas are removed:
 
 # fig-region-trimmed
 heatmap(trim(layer); colormap = :navia, axis = (; aspect = DataAspect()))

docs/src/tutorials/zonal.jl

@@ -29,7 +29,8 @@ hidespines!(ax)
 hidedecorations!(ax)
 current_figure() #hide
 
-# We can now get the lower level sub-division:
+# We can now get the lower level sub-division. Note that not all territories
+# covered by GADM have the same number of sub-divisions!
 
 districts = SpeciesDistributionToolkit.gadm("NZL", 2);