# Documenter.jl not including any definitions and then complaining that they're missing

**URL:** <https://discourse.julialang.org/t/documenter-jl-not-including-any-definitions-and-then-complaining-that-theyre-missing/124644>\
**Category:** General Usage\
**Tags:** documentation, documenter, documenterjl\
**Created:** [January 10, 2025, 2:57pm UTC](https://discourse.julialang.org/t/documenter-jl-not-including-any-definitions-and-then-complaining-that-theyre-missing/124644 "2025-01-10T14:57:02Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Mark\_Nahabedian](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mark_nahabedian/32/16562_2.png) [@Mark\_Nahabedian](https://discourse.julialang.org/u/Mark_Nahabedian)\
**Post date:** [January 10, 2025, 2:57pm UTC](https://discourse.julialang.org/t/documenter-jl-not-including-any-definitions-and-then-complaining-that-theyre-missing/124644/1 "2025-01-10T14:57:02Z")

</div>

One of my projects, [GitHub - MarkNahabedian/Rete.jl: An inplementation of the Rete knowledge based system shell.](https://github.com/MarkNahabedian/Rete.jl), 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.

```julia

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”

```julia

Thanks.
```

---

<div class="post-metadata">

**Author:** ![Mark\_Nahabedian](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mark_nahabedian/32/16562_2.png) [@Mark\_Nahabedian](https://discourse.julialang.org/u/Mark_Nahabedian)\
**Post date:** [February 18, 2025, 3:34pm UTC](https://discourse.julialang.org/t/documenter-jl-not-including-any-definitions-and-then-complaining-that-theyre-missing/124644/2 "2025-02-18T15:34:00Z")

</div>

The problem was a space character that emacs snuck in at the beginning of a closing codefence line.

I found this by looking at the AST returned by calling `Markdown.parse` on my markdown file.