One of my projects, GitHub - MarkNahabedian/Rete.jl: An inplementation of the Rete knowledge based system shell., is
failing its documentation build both in its CI GitHub action and
locally.
This documentetion used to build, as evidenced by the repository’s
gh-pages branch and the actions report for CI #70. For some reason,
the GitHub web UI doesn’t believe that it’s users might want to know
the date and time of a given CI run despite GitHub being a tool that
is all about history.
…
┌ Error: Cannot resolve @ref for md"AbstractReteNode
" in src/index.md.
│ - No docstring found in doc for binding Rete.AbstractReteNode
.
│ - No docstring found in doc for binding Rete.AbstractReteNode
.
└ @ Documenter ~/.julia/packages/Documenter/Bs999/src/utilities/utilities.jl:44
[ Info: CheckDocument: running document checks.
┌ Error: 42 docstrings not included in the manual:
│
│ Rete.fact_count :: Tuple{AbstractReteNode}
│ Rete.add_forward_trigger :: Tuple{JoinNode, AbstractReteNode}
…
│ These are docstrings in the checked modules (configured with the modules keyword)
│ that are not included in canonical @docs or @autodocs blocks.
└ @ Documenter ~/.julia/packages/Documenter/Bs999/src/utilities/utilities.jl:44
[ Info: Populate: populating indices.
ERROR: LoadError: makedocs
encountered errors [:missing_docs, :cross_references] – terminating build before rendering.
I don't know why these doc strings are not included. The `index.md`
file includes an `@autodocs` block.
Even if I include all of the liated names in an explicit `@docs`
block, I still get the same error.
Am I doing something wrong or is Documenter.jl broken?
From Documenter's `Project.toml`:
name = “Documenter”
uuid = “e30172f5-a6a5-5a46-863b-614d45cd2de4”
version = “1.8.0”
Thanks.