docs: Update to a new version of documenter and skip develop

- New documenter generates `objects.inv` which allows for external
  references
- Adding the `sources` section in the `Project.toml` ensures that the
  documentation is always built for the current developed version and
  not for the stable version fetched from the registry even if `develop`
  is skipped in the generation process which ensures that no head
  scratching issues happen during the development.

Author: kunzaatko

.github/workflows/docs.yml

@@ -34,7 +34,7 @@ jobs:
             ${{ runner.os }}-test-
             ${{ runner.os }}-
       - name: Install dependencies
-        run: julia --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()'
+        run: julia --project=docs/ -e 'using Pkg; Pkg.instantiate()'
       - name: Build and deploy
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

docs/Project.toml

@@ -3,6 +3,9 @@ Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 JSON = "682c06a0-de6a-54ab-a142-c8b1cf79cde6"
 OffsetArrays = "6fe1bfb0-de20-5000-8ca7-80f57d26f881"
 
+[sources]
+OffsetArrays = { path = ".." }
+
 [compat]
-Documenter = "0.27"
+Documenter = "^1"
 JSON = "0.21"