add dimensions docs to default units docs chapter (#794)

* add dimensions docs to default units docs chapter

* replace actual docstring text by @docs

* Delete hundreds of useless lines in `docs/src/defaultunits.md`

* Add `Unitful` to `docs` environment using `sources`

* [CI] Upload docs build as artifact

* Switch order of dimension and quantities

* Remove leftover section header


---------

Co-authored-by: Mosè Giordano <[email protected]>
Co-authored-by: Sebastian Stock <[email protected]>

Author: 3 people

.github/workflows/documentation.yaml

@@ -36,3 +36,8 @@ jobs:
       - uses: julia-actions/julia-docdeploy@v1
         env:
           DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: documentation-build
+          path: docs/build
+          retention-days: 90

docs/Project.toml

@@ -9,6 +9,10 @@ Plots = "91a5bcdd-55d7-5caf-9e0b-520d859cae80"
 Unitful = "1986cc42-f94f-5a68-af5c-568840ba703d"
 tectonic_jll = "d7dd28d6-a5e6-559c-9131-7eb760cdacc5"
 
+[sources]
+Unitful = {path = ".."}
+
 [compat]
 Documenter = "1"
 Latexify = "0.16.9"
+Plots = "1"

docs/make.jl

@@ -25,7 +25,7 @@ makedocs(
         "Latexifying units" => "latexify.md"
         "Extending Unitful" => "extending.md"
         "Troubleshooting" => "trouble.md"
-        "Pre-defined units and constants" => "defaultunits.md"
+        "Pre-defined dimensions, units, and constants" => "defaultunits.md"
         "License" => "LICENSE.md"
     ]
 )